@bugzy-ai/bugzy 1.18.0 → 1.18.2

package/dist/tasks/index.js

@@ -17,6 +17,7 @@ var TASK_SLUGS = {
   RUN_TESTS: "run-tests",
   VERIFY_CHANGES: "verify-changes",
   TRIAGE_RESULTS: "triage-results",
+  EXPLORE_TEST_CODEBASE: "explore-test-codebase",
   /** @deprecated Use ONBOARD_TESTING instead */
   FULL_TEST_COVERAGE: "onboard-testing"
 };
@@ -689,7 +690,29 @@ Read \`.bugzy/runtime/memory/event-history.md\` to:
 - List \`./test-cases/\` for existing tests
 - Check \`.bugzy/runtime/knowledge-base.md\` for past insights
 
-#### 2.4 Event-Action Reference Patterns
+#### 2.4 Knowledge Base: Drafted vs Real Tests (BYOT)
+
+When the project uses an external test repository, maintain two sections in \`.bugzy/runtime/knowledge-base.md\`:
+
+**Drafted Tests** (Open PRs \u2014 tests not yet merged):
+\`\`\`markdown
+### Drafted Tests
+| PR | Branch | Tests Added | Status | Date |
+|----|--------|-------------|--------|------|
+| #12 | bugzy/verify-changes-a1b2c3d4 | login.spec.ts, checkout.spec.ts | Open | 2026-02-13 |
+\`\`\`
+
+**Active Tests** (Merged \u2014 tests are part of the test suite):
+\`\`\`markdown
+### Active Tests
+| File | What it tests | Source PR | Merged |
+|------|---------------|-----------|--------|
+| login.spec.ts | Login flow with valid/invalid credentials | #12 | 2026-02-13 |
+\`\`\`
+
+Move entries from Drafted \u2192 Active Tests when PRs are merged. Remove entries when PRs are closed without merge.
+
+#### 2.5 Event-Action Reference Patterns
 
 Use these as reference patterns for common events. The webhook routing system already handles events with specific default tasks (e.g., deployment_status \u2192 /run-tests). Process-event receives events that need analysis.
 
@@ -708,6 +731,23 @@ Use these as reference patterns for common events. The webhook routing system al
 - **QA-relevant content found**: Propose appropriate follow-up tasks (e.g., \`/generate-test-cases\`, \`/verify-changes\`)
 - **No QA content** (HR meeting, offsite planning, etc.): Skip \u2014 log to event history only
 
+**External Test Repo Events** (BYOT - events from the customer's external test repository):
+- **PR opened by Bugzy** (\`com.github.external_repo.pull_request\`, \`action: "opened"\`, branch starts with \`bugzy/\`):
+  Log to Knowledge Base under "Drafted Tests". No action task needed \u2014 just record the PR number, branch, and what tests were added.
+- **PR review submitted** (\`com.github.external_repo.pull_request_review\`):
+  If changes were requested \u2192 queue \`/verify-changes\` with \`{"existingPrBranch": "{head.ref}", "context": "PR review feedback: {review.body}"}\`.
+  The execution will iterate on the existing branch, push fixes, and skip PR creation.
+- **PR comment** (\`com.github.external_repo.pull_request_comment\`):
+  Read the comment. If it contains actionable feedback, queue \`/verify-changes\`
+  with \`{"existingPrBranch": "{issue.pull_request.head.ref}"}\`.
+- **PR merged** (\`com.github.external_repo.pull_request\`, \`action: "closed"\`, \`merged: true\`):
+  Update Knowledge Base: move entries from "Drafted Tests" to "Active Tests". Notify team of new test coverage.
+  The submodule pointer update happens automatically via the container (\`updateSubmoduleToLatest\`).
+- **PR closed without merge** (\`com.github.external_repo.pull_request\`, \`action: "closed"\`, \`merged: false\`):
+  Remove from Knowledge Base "Drafted Tests". Notify team that tests were rejected.
+- **Direct push to main** (\`com.github.external_repo.push\`, ref is main/master):
+  Update Knowledge Base if test files were affected. Submodule pointer update is automatic.
+
 **Other Events:**
 - Analyze for QA relevance based on knowledge base and project context
 - If action needed, propose appropriate task. If not, log and skip.
@@ -1867,6 +1907,93 @@ Output this JSON as the final result of the task.`
   dependentTasks: []
 };
 
+// src/tasks/library/explore-test-codebase.ts
+var exploreTestCodebaseTask = {
+  slug: TASK_SLUGS.EXPLORE_TEST_CODEBASE,
+  name: "Explore Test Codebase",
+  description: "Analyze external test repository to understand framework, coverage, and conventions",
+  frontmatter: {
+    description: "Analyze external test codebase for BYOT onboarding",
+    "argument-hint": "--focus [area]"
+  },
+  steps: [
+    // Step 1: Overview (inline)
+    {
+      inline: true,
+      title: "Explore Test Codebase Overview",
+      content: `Analyze the external test repository to understand the testing framework, test coverage, conventions, and codebase structure. This task is triggered during BYOT (Bring Your Own Tests) onboarding to help Bugzy understand the customer's existing test suite.`
+    },
+    // Step 2: Security Notice
+    "security-notice",
+    // Step 3: Arguments (inline)
+    {
+      inline: true,
+      title: "Arguments",
+      content: `**Arguments**: $ARGUMENTS
+
+**Parse:**
+- **focus**: specific area to analyze (default: comprehensive)`
+    },
+    // Setup
+    "load-project-context",
+    "read-knowledge-base",
+    // Core analysis
+    "analyze-test-codebase",
+    // Generate results parser for normalizing test output
+    "create-results-parser",
+    // Optional: explore the app itself if URL is available
+    {
+      inline: true,
+      title: "App Exploration (Optional)",
+      content: `If the project has an app URL configured (check \`.bugzy/runtime/project-context.md\` or env vars for TEST_APP_HOST), {{INVOKE_BROWSER_AUTOMATION}} to briefly explore the application:
+
+1. Navigate to the app URL
+2. Identify main navigation and key pages
+3. Map discovered features to test coverage from the codebase analysis
+4. Note any features that appear untested
+
+This step helps correlate what the tests cover with what the application actually contains. Skip if no app URL is available.`,
+      conditionalOnSubagent: "browser-automation"
+    },
+    // Generate output
+    {
+      inline: true,
+      title: "Commit Analysis Results",
+      content: `Commit all analysis artifacts to the project repository:
+
+1. The test codebase analysis report (\`.bugzy/runtime/test-codebase-analysis.md\`)
+2. Any generated CLAUDE.md draft (if the external repo was missing one)
+
+Use a clear commit message: "chore: analyze external test codebase"
+
+These artifacts will be available to all future task executions for this project.`
+    },
+    // Team Communication (conditional)
+    {
+      inline: true,
+      title: "Team Communication",
+      content: `{{INVOKE_TEAM_COMMUNICATOR}} to notify the team about the test codebase analysis:
+
+\`\`\`
+1. Post a summary of the analysis findings
+2. Include key information:
+   - Test framework and runner identified
+   - Number of test files and estimated test cases
+   - Feature areas covered by existing tests
+   - Any gaps or areas without test coverage
+3. Ask if the analysis looks accurate
+4. Use appropriate channel and threading
+\`\`\``,
+      conditionalOnSubagent: "team-communicator"
+    },
+    // Maintenance
+    "update-knowledge-base"
+  ],
+  requiredSubagents: ["browser-automation"],
+  optionalSubagents: ["team-communicator"],
+  dependentTasks: []
+};
+
 // src/tasks/index.ts
 var TASK_TEMPLATES = {
   [TASK_SLUGS.GENERATE_TEST_CASES]: generateTestCasesTask,
@@ -1877,7 +2004,8 @@ var TASK_TEMPLATES = {
   [TASK_SLUGS.VERIFY_CHANGES]: verifyChangesTask,
   [TASK_SLUGS.ONBOARD_TESTING]: onboardTestingTask,
   [TASK_SLUGS.EXPLORE_APPLICATION]: exploreApplicationTask,
-  [TASK_SLUGS.TRIAGE_RESULTS]: triageResultsTask
+  [TASK_SLUGS.TRIAGE_RESULTS]: triageResultsTask,
+  [TASK_SLUGS.EXPLORE_TEST_CODEBASE]: exploreTestCodebaseTask
 };
 function getTaskTemplate(slug) {
   return TASK_TEMPLATES[slug];