@bugzy-ai/bugzy 1.18.5 → 1.19.0

package/dist/cli/index.cjs

@@ -137,10 +137,6 @@ Extract the following from arguments:
 - **type**: Test type (exploratory, functional, regression, smoke) - defaults to functional
 - **focus**: Optional specific feature or section to focus on`
         },
-        // Step 4: Load Project Context (library)
-        "load-project-context",
-        // Step 5: Knowledge Base Read (library)
-        "read-knowledge-base",
         // Step 5: Gather Context (inline)
         {
           inline: true,
@@ -352,11 +348,7 @@ var init_generate_test_plan = __esm({
           title: "Arguments",
           content: `Product description: $ARGUMENTS`
         },
-        // Step 4: Load Project Context (library)
-        "load-project-context",
-        // Step 5: Knowledge Base Read (library)
-        "read-knowledge-base",
-        // Step 6: Process Description (inline)
+        // Step 5: Process Description (inline)
         {
           inline: true,
           title: "Process the Product Description",
@@ -540,10 +532,6 @@ Process team messages and handle multi-turn conversations with the product team
           title: "Arguments",
           content: `Team message/thread context: $ARGUMENTS`
         },
-        // Step 4: Load Project Context (library)
-        "load-project-context",
-        // Step 5: Knowledge Base Read (library)
-        "read-knowledge-base",
         // Step 6: Detect Intent (inline - simplified, no handler file loading)
         {
           inline: true,
@@ -746,10 +734,6 @@ Process webhook events from integrated systems by analyzing event content, deter
           title: "Arguments",
           content: `Arguments: $ARGUMENTS`
         },
-        // Step 4: Load Project Context (library)
-        "load-project-context",
-        // Step 5: Knowledge Base Read (library)
-        "read-knowledge-base",
         // Step 5: Understand Event Context (inline)
         {
           inline: true,
@@ -1226,10 +1210,6 @@ Extract the following from arguments:
   - Specific file: path to a specific test file
   - All tests: "all" or "" \u2192 runs entire test suite`
         },
-        // Step 4: Load Project Context (library)
-        "load-project-context",
-        // Step 5: Knowledge Base Read (library)
-        "read-knowledge-base",
         // Step 5: Test Execution Strategy (library)
         "read-test-strategy",
         // Step 6: Clarification Protocol (library)
@@ -1386,10 +1366,6 @@ This task performs comprehensive change verification with:
 
 The input format determines the trigger source and context extraction strategy.`
         },
-        // Step 4: Load Project Context (library)
-        "load-project-context",
-        // Step 5: Knowledge Base Read (library)
-        "read-knowledge-base",
         // Step 5: Detect Trigger Source (inline)
         {
           inline: true,
@@ -1799,7 +1775,9 @@ Include in the message:
 - Any blocking issues or critical findings`,
           conditionalOnSubagent: "team-communicator"
         },
-        // Step 15: Documentation Research (conditional library step)
+        // Step 15: Knowledge Base Update (library)
+        "update-knowledge-base",
+        // Step 16: Documentation Research (conditional library step)
         {
           stepId: "gather-documentation",
           conditionalOnSubagent: "documentation-researcher"
@@ -1850,9 +1828,7 @@ Output to CI build log (print detailed results to stdout) and exit with appropri
 Post PR comment if GitHub context available.`,
           conditionalOnSubagent: "team-communicator"
         },
-        // Step 17: Knowledge Base Update (library)
-        "update-knowledge-base",
-        // Step 18: Handle Special Cases (inline)
+        // Step 17: Handle Special Cases (inline)
         {
           inline: true,
           title: "Handle Special Cases",
@@ -1912,8 +1888,6 @@ This command orchestrates the complete test coverage workflow in a single execut
           content: `Focus area: $ARGUMENTS`
         },
         // Phase 1: Setup
-        "load-project-context",
-        "read-knowledge-base",
         {
           stepId: "gather-documentation",
           conditionalOnSubagent: "documentation-researcher"
@@ -1990,9 +1964,6 @@ var init_explore_application = __esm({
 - **depth**: shallow (15-20 min) or deep (45-60 min, default)
 - **system**: target system (optional for multi-system setups)`
         },
-        // Setup
-        "load-project-context",
-        "read-knowledge-base",
         // Exploration Protocol (adaptive depth)
         "exploration-protocol",
         // Execute
@@ -2065,11 +2036,7 @@ This task is triggered automatically when test results are submitted to the Bugz
           title: "Arguments",
           content: `Arguments: $ARGUMENTS`
         },
-        // Step 4: Load Project Context (library)
-        "load-project-context",
-        // Step 5: Knowledge Base Read (library)
-        "read-knowledge-base",
-        // Step 6: Normalize Test Results (library — handles URL/inline results + manifest creation)
+        // Step 5: Normalize Test Results (library — handles URL/inline results + manifest creation)
         "normalize-test-results",
         // Step 7: Triage Failures (existing library step)
         "triage-failures",
@@ -2080,57 +2047,13 @@ This task is triggered automatically when test results are submitted to the Bugz
           stepId: "log-product-bugs",
           conditionalOnSubagent: "issue-tracker"
         },
-        // Step 10: Update Knowledge Base (library)
-        "update-knowledge-base",
-        // Step 11: Notify Team (conditional — requires team-communicator)
+        // Step 10: Notify Team (conditional — requires team-communicator)
         {
           stepId: "notify-team",
           conditionalOnSubagent: "team-communicator"
         },
-        // Step 12: Generate Triage Report (inline)
-        {
-          inline: true,
-          title: "Generate Triage Report",
-          content: `## Generate Triage Report
-
-Create a structured triage report as the task output. This report is stored in \`task_executions.result\` and displayed in the Bugzy dashboard.
-
-**Report Structure:**
-\`\`\`json
-{
-  "summary": {
-    "total": <number>,
-    "passed": <number>,
-    "failed": <number>,
-    "skipped": <number>,
-    "duration_ms": <number or null>
-  },
-  "ci_metadata": {
-    "pipeline_url": "<from event payload>",
-    "commit_sha": "<from event payload>",
-    "branch": "<from event payload>"
-  },
-  "triage": {
-    "product_bugs": [
-      {
-        "test_name": "<name>",
-        "error": "<brief error>",
-        "reason": "<why this is a product bug>"
-      }
-    ],
-    "test_issues": [
-      {
-        "test_name": "<name>",
-        "error": "<brief error>",
-        "reason": "<why this is a test issue>"
-      }
-    ]
-  }
-}
-\`\`\`
-
-Output this JSON as the final result of the task.`
-        }
+        // Step 11: Knowledge Base Update (library)
+        "update-knowledge-base"
       ],
       requiredSubagents: ["browser-automation", "test-engineer"],
       optionalSubagents: ["issue-tracker", "team-communicator"],
@@ -2172,9 +2095,6 @@ var init_explore_test_codebase = __esm({
 **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
@@ -2861,7 +2781,7 @@ async function startSession(prompt) {
 
 // src/cli/commands/setup.ts
 init_cjs_shims();
-var path11 = __toESM(require("path"), 1);
+var path12 = __toESM(require("path"), 1);
 var import_chalk2 = __toESM(require("chalk"), 1);
 var import_inquirer = __toESM(require("inquirer"), 1);
 var import_ora2 = __toESM(require("ora"), 1);
@@ -5596,7 +5516,9 @@ async function createProjectStructure(tool = DEFAULT_TOOL) {
   const bugzyDirs = [
     ".bugzy",
     ".bugzy/runtime",
-    ".bugzy/runtime/templates"
+    ".bugzy/runtime/templates",
+    ".bugzy/runtime/hooks",
+    ".bugzy/runtime/logs"
   ];
   for (const dir of bugzyDirs) {
     const dirPath = path5.join(cwd, dir);
@@ -5685,6 +5607,15 @@ async function createRuntimeFiles() {
       fs4.writeFileSync(subagentMemoryPath, content, "utf-8");
     }
   }
+  const hookScripts = ["session-start.sh", "pre-compact.sh", "stop.sh"];
+  for (const script of hookScripts) {
+    const destPath = path5.join(cwd, ".bugzy/runtime/hooks", script);
+    const templatePath = path5.join(templatesDir, ".bugzy/runtime/hooks", script);
+    if (fs4.existsSync(templatePath)) {
+      fs4.copyFileSync(templatePath, destPath);
+      fs4.chmodSync(destPath, 493);
+    }
+  }
   const testExecutionStrategyPath = path5.join(cwd, "tests/docs/test-execution-strategy.md");
   if (!fs4.existsSync(testExecutionStrategyPath)) {
     const templatePath = path5.join(templatesDir, "tests/docs/test-execution-strategy.md");
@@ -5759,39 +5690,6 @@ init_tasks();
 // src/tasks/steps/index.ts
 init_cjs_shims();
 
-// src/tasks/steps/setup/read-knowledge-base.ts
-init_cjs_shims();
-var readKnowledgeBaseStep = {
-  id: "read-knowledge-base",
-  title: "Read Knowledge Base",
-  category: "setup",
-  content: `## Knowledge Base Context
-
-Before proceeding, read the curated knowledge base to inform your work:
-
-**Location:** \`.bugzy/runtime/knowledge-base.md\`
-
-**Purpose:** The knowledge base is a living collection of factual knowledge - what we currently know and believe to be true about this project, its patterns, and its context. This is NOT a historical log, but a curated snapshot that evolves as understanding improves.
-
-**How to Use:**
-1. Read the knowledge base to understand:
-   - Project-specific patterns and conventions
-   - Known behaviors and system characteristics
-   - Relevant context from past work
-   - Documented decisions and approaches
-
-2. Apply this knowledge to:
-   - Make informed decisions aligned with project patterns
-   - Avoid repeating past mistakes
-   - Build on existing understanding
-   - Maintain consistency with established practices
-
-3. **Relay to subagents**: Subagents do NOT read the knowledge base directly. When delegating work, you MUST include relevant KB patterns in your delegation message \u2014 especially testing patterns (timing, selectors, assertion approaches) that affect test reliability.
-
-**Note:** The knowledge base may not exist yet or may be empty. If it doesn't exist or is empty, proceed without this context and help build it as you work.`,
-  tags: ["setup", "context"]
-};
-
 // src/tasks/steps/setup/read-test-strategy.ts
 init_cjs_shims();
 var readTestStrategyStep = {
@@ -5814,39 +5712,6 @@ Apply the strategy guidance when determining which tests to run.
   tags: ["setup", "test-execution", "strategy"]
 };
 
-// src/tasks/steps/setup/load-project-context.ts
-init_cjs_shims();
-var loadProjectContextStep = {
-  id: "load-project-context",
-  title: "Load Project Context",
-  category: "setup",
-  content: `## Load Project Context
-
-Check for existing project context to inform your work:
-
-**1. Check Project Context**
-- Read \`.bugzy/runtime/project-context.md\` if it exists
-- Check if it contains information relevant to: $ARGUMENTS
-- This file contains:
-  - Application overview and architecture
-  - Key user flows and features
-  - Technical patterns discovered
-  - Environment details
-
-**2. Check Test Execution Strategy**
-- Read \`./tests/docs/test-execution-strategy.md\` if it exists
-- Understand available test tiers and when to use them
-- Note default behaviors and time/coverage trade-offs
-
-**3. Document Findings**
-Note what context is available:
-\`\`\`
-Project Context: [exists/missing] - [relevant to focus area: yes/no/partial]
-Test Strategy: [exists/missing]
-\`\`\``,
-  tags: ["setup", "context"]
-};
-
 // src/tasks/steps/setup/security-notice.ts
 init_cjs_shims();
 var securityNoticeStep = {
@@ -7085,41 +6950,6 @@ Notify the team about progress and results:
   tags: ["communication", "optional"]
 };
 
-// src/tasks/steps/maintenance/update-knowledge-base.ts
-init_cjs_shims();
-var updateKnowledgeBaseStep = {
-  id: "update-knowledge-base",
-  title: "Update Knowledge Base",
-  category: "maintenance",
-  content: `## Knowledge Base Maintenance
-
-After completing your work, update the knowledge base with new insights.
-
-**Location:** \`.bugzy/runtime/knowledge-base.md\`
-
-**Process:**
-
-1. **Read the maintenance guide** at \`.bugzy/runtime/knowledge-maintenance-guide.md\` to understand when to ADD, UPDATE, or REMOVE entries and how to maintain a curated knowledge base (not an append-only log)
-
-2. **Review the current knowledge base** to check for overlaps, contradictions, or opportunities to consolidate existing knowledge
-
-3. **Update the knowledge base** following the maintenance guide principles:
-   - Favor consolidation over addition
-   - Update rather than append
-   - Resolve contradictions immediately
-   - Focus on quality over completeness
-
-**What to Add:**
-- New patterns discovered about the application
-- Behaviors that differ from expectations
-- Technical constraints or requirements
-- Useful selectors or navigation patterns
-- Error handling patterns
-
-**Remember:** Every entry should answer "Will this help someone working on this project in 6 months?"`,
-  tags: ["maintenance", "knowledge"]
-};
-
 // src/tasks/steps/maintenance/generate-final-report.ts
 init_cjs_shims();
 var generateFinalReportStep = {
@@ -7296,14 +7126,47 @@ For each modified test case:
   tags: ["maintenance", "automation", "feedback"]
 };
 
+// src/tasks/steps/maintenance/update-knowledge-base.ts
+init_cjs_shims();
+var updateKnowledgeBaseStep = {
+  id: "update-knowledge-base",
+  title: "Update Knowledge Base",
+  category: "maintenance",
+  content: `## Knowledge Base Maintenance
+
+After completing your work, update the knowledge base with new insights.
+
+**Location:** \`.bugzy/runtime/knowledge-base.md\`
+
+**Process:**
+
+1. **Read the maintenance guide** at \`.bugzy/runtime/knowledge-maintenance-guide.md\` to understand when to ADD, UPDATE, or REMOVE entries and how to maintain a curated knowledge base (not an append-only log)
+
+2. **Review the current knowledge base** to check for overlaps, contradictions, or opportunities to consolidate existing knowledge
+
+3. **Update the knowledge base** following the maintenance guide principles:
+   - Favor consolidation over addition
+   - Update rather than append
+   - Resolve contradictions immediately
+   - Focus on quality over completeness
+
+**What to Add:**
+- New patterns discovered about the application
+- Behaviors that differ from expectations
+- Technical constraints or requirements
+- Useful selectors or navigation patterns
+- Error handling patterns
+
+**Remember:** Every entry should answer "Will this help someone working on this project in 6 months?"`,
+  tags: ["maintenance", "knowledge"]
+};
+
 // src/tasks/steps/index.ts
 init_types();
 var STEP_LIBRARY = {
   // Setup
   "security-notice": securityNoticeStep,
-  "read-knowledge-base": readKnowledgeBaseStep,
   "read-test-strategy": readTestStrategyStep,
-  "load-project-context": loadProjectContextStep,
   "gather-documentation": gatherDocumentationStep,
   // Exploration
   "exploration-protocol": explorationProtocolStep,
@@ -7329,12 +7192,12 @@ var STEP_LIBRARY = {
   // Communication
   "notify-team": notifyTeamStep,
   // Maintenance
-  "update-knowledge-base": updateKnowledgeBaseStep,
   "generate-final-report": generateFinalReportStep,
   "update-exploration-artifacts": updateExplorationArtifactsStep,
   "cleanup-temp-files": cleanupTempFilesStep,
   "validate-test-artifacts": validateTestArtifactsStep,
-  "sync-automation-from-feedback": syncAutomationFromFeedbackStep
+  "sync-automation-from-feedback": syncAutomationFromFeedbackStep,
+  "update-knowledge-base": updateKnowledgeBaseStep
 };
 function getStep(id) {
   const step = STEP_LIBRARY[id];
@@ -7896,17 +7759,85 @@ function getMCPServersFromSubagents(subagents) {
   return Array.from(mcps);
 }
 
+// src/cli/generators/settings.ts
+init_cjs_shims();
+var fs8 = __toESM(require("fs"), 1);
+var path9 = __toESM(require("path"), 1);
+function buildAllowPermissions(subagents) {
+  const allow = [
+    // Common permissions
+    "Bash(mkdir:*)",
+    "Bash(git grep:*)",
+    "Bash(git init:*)",
+    "Bash(git --no-pager status --porcelain)",
+    "Bash(git --no-pager diff --stat HEAD)",
+    "Bash(git --no-pager log --oneline -5)",
+    "Bash(git --no-pager status)",
+    "Bash(git --no-pager diff HEAD)"
+  ];
+  if (subagents["browser-automation"]) {
+    allow.push("Bash(playwright-cli:*)");
+  }
+  if (subagents["team-communicator"] === "slack") {
+    allow.push("mcp__slack__slack_list_channels");
+    allow.push("mcp__slack__slack_post_rich_message");
+  }
+  if (subagents["documentation-researcher"] === "notion") {
+    allow.push("mcp__notion__API-post-database-query");
+    allow.push("mcp__notion__API-retrieve-a-database");
+  }
+  return allow;
+}
+async function generateSettings(subagents, tool = DEFAULT_TOOL) {
+  if (tool !== "claude-code") {
+    return;
+  }
+  const cwd = process.cwd();
+  const settingsPath = path9.join(cwd, ".claude", "settings.json");
+  const claudeDir = path9.dirname(settingsPath);
+  if (!fs8.existsSync(claudeDir)) {
+    fs8.mkdirSync(claudeDir, { recursive: true });
+  }
+  const hooks = {
+    SessionStart: [{
+      hooks: [{
+        type: "command",
+        command: "bash .bugzy/runtime/hooks/session-start.sh"
+      }]
+    }],
+    PreCompact: [{
+      hooks: [{
+        type: "command",
+        command: "bash .bugzy/runtime/hooks/pre-compact.sh"
+      }]
+    }]
+  };
+  const allow = buildAllowPermissions(subagents);
+  const mcpServers = getMCPServersFromSubagents(subagents);
+  const settings = {
+    hooks,
+    permissions: {
+      allow,
+      deny: ["Read(.env)"],
+      ask: []
+    },
+    enabledMcpjsonServers: mcpServers
+  };
+  const content = JSON.stringify(settings, null, 2);
+  fs8.writeFileSync(settingsPath, content, "utf-8");
+}
+
 // src/cli/commands/setup.ts
 var import_child_process4 = require("child_process");
 
 // src/cli/generators/env.ts
 init_cjs_shims();
-var fs8 = __toESM(require("fs"), 1);
-var path9 = __toESM(require("path"), 1);
+var fs9 = __toESM(require("fs"), 1);
+var path10 = __toESM(require("path"), 1);
 async function generateEnvExample(mcpServers) {
   const cwd = process.cwd();
-  const envExamplePath = path9.join(cwd, ".env.example");
-  const envPath = path9.join(cwd, ".env");
+  const envExamplePath = path10.join(cwd, ".env.example");
+  const envPath = path10.join(cwd, ".env");
   const header = `# ============================================
 # Bugzy OSS - Environment Variables
 # ============================================
@@ -7937,9 +7868,9 @@ async function generateEnvExample(mcpServers) {
     }
   }
   const content = header + mcpSection + testDataSecretsSection;
-  fs8.writeFileSync(envExamplePath, content, "utf-8");
-  if (!fs8.existsSync(envPath)) {
-    fs8.writeFileSync(envPath, content, "utf-8");
+  fs9.writeFileSync(envExamplePath, content, "utf-8");
+  if (!fs9.existsSync(envPath)) {
+    fs9.writeFileSync(envPath, content, "utf-8");
   }
 }
 function getMCPEnvConfig(serverName) {
@@ -7992,8 +7923,8 @@ RESEND_FROM_EMAIL=`
 
 // src/cli/generators/scaffold-playwright.ts
 init_cjs_shims();
-var fs9 = __toESM(require("fs"), 1);
-var path10 = __toESM(require("path"), 1);
+var fs10 = __toESM(require("fs"), 1);
+var path11 = __toESM(require("path"), 1);
 var import_child_process3 = require("child_process");
 async function scaffoldPlaywrightProject(options) {
   const { projectName, targetDir, skipInstall = false } = options;
@@ -8022,25 +7953,25 @@ async function createDirectoryStructure(targetDir) {
     "test-runs"
   ];
   for (const dir of directories) {
-    const fullPath = path10.join(targetDir, dir);
-    if (!fs9.existsSync(fullPath)) {
-      fs9.mkdirSync(fullPath, { recursive: true });
+    const fullPath = path11.join(targetDir, dir);
+    if (!fs10.existsSync(fullPath)) {
+      fs10.mkdirSync(fullPath, { recursive: true });
       console.log(`  \u2713 Created ${dir}/`);
     }
   }
 }
 async function copyTemplateFiles(targetDir, projectName) {
   const possiblePaths = [
-    path10.join(__dirname, "../../templates/playwright"),
+    path11.join(__dirname, "../../templates/playwright"),
     // When running from dist
-    path10.join(process.cwd(), "templates/playwright"),
+    path11.join(process.cwd(), "templates/playwright"),
     // When running from project root
-    path10.join(__dirname, "../../../templates/playwright")
+    path11.join(__dirname, "../../../templates/playwright")
     // When running tests
   ];
   let templatesDir = "";
   for (const possiblePath of possiblePaths) {
-    if (fs9.existsSync(possiblePath)) {
+    if (fs10.existsSync(possiblePath)) {
       templatesDir = possiblePath;
       break;
     }
@@ -8048,12 +7979,12 @@ async function copyTemplateFiles(targetDir, projectName) {
   if (!templatesDir) {
     throw new Error("Templates directory not found. Searched paths: " + possiblePaths.join(", "));
   }
-  const initTemplatesDir = path10.join(__dirname, "../../templates/init");
-  const testRunsReadmeSrc = path10.join(initTemplatesDir, "test-runs/README.md");
-  const testRunsReadmeDest = path10.join(targetDir, "test-runs/README.md");
-  if (fs9.existsSync(testRunsReadmeSrc)) {
-    const content = fs9.readFileSync(testRunsReadmeSrc, "utf-8");
-    fs9.writeFileSync(testRunsReadmeDest, content, "utf-8");
+  const initTemplatesDir = path11.join(__dirname, "../../templates/init");
+  const testRunsReadmeSrc = path11.join(initTemplatesDir, "test-runs/README.md");
+  const testRunsReadmeDest = path11.join(targetDir, "test-runs/README.md");
+  if (fs10.existsSync(testRunsReadmeSrc)) {
+    const content = fs10.readFileSync(testRunsReadmeSrc, "utf-8");
+    fs10.writeFileSync(testRunsReadmeDest, content, "utf-8");
     console.log(`  \u2713 Created test-runs/README.md`);
   }
   const templates = [
@@ -8094,10 +8025,10 @@ async function copyTemplateFiles(targetDir, projectName) {
     }
   ];
   for (const template of templates) {
-    const srcPath = path10.join(templatesDir, template.src);
-    const destPath = path10.join(targetDir, template.dest);
-    if (fs9.existsSync(srcPath)) {
-      let content = fs9.readFileSync(srcPath, "utf-8");
+    const srcPath = path11.join(templatesDir, template.src);
+    const destPath = path11.join(targetDir, template.dest);
+    if (fs10.existsSync(srcPath)) {
+      let content = fs10.readFileSync(srcPath, "utf-8");
       if (template.process) {
         content = processTemplate(content, {
           PROJECT_NAME: projectName,
@@ -8105,11 +8036,11 @@ async function copyTemplateFiles(targetDir, projectName) {
           DATE: (/* @__PURE__ */ new Date()).toISOString().split("T")[0]
         });
       }
-      const destDir = path10.dirname(destPath);
-      if (!fs9.existsSync(destDir)) {
-        fs9.mkdirSync(destDir, { recursive: true });
+      const destDir = path11.dirname(destPath);
+      if (!fs10.existsSync(destDir)) {
+        fs10.mkdirSync(destDir, { recursive: true });
       }
-      fs9.writeFileSync(destPath, content, "utf-8");
+      fs10.writeFileSync(destPath, content, "utf-8");
       console.log(`  \u2713 Created ${template.dest}`);
     } else {
       console.warn(`  \u26A0\uFE0F  Template not found: ${template.src}`);
@@ -8125,7 +8056,7 @@ function processTemplate(content, values) {
   return processed;
 }
 async function updateGitignore2(targetDir) {
-  const gitignorePath = path10.join(targetDir, ".gitignore");
+  const gitignorePath = path11.join(targetDir, ".gitignore");
   const playwrightEntries = `
 # Playwright
 test-results/
@@ -8133,19 +8064,19 @@ playwright-report/
 tests/.auth/
 .env
 `;
-  if (fs9.existsSync(gitignorePath)) {
-    const content = fs9.readFileSync(gitignorePath, "utf-8");
+  if (fs10.existsSync(gitignorePath)) {
+    const content = fs10.readFileSync(gitignorePath, "utf-8");
     if (!content.includes("# Playwright")) {
-      fs9.appendFileSync(gitignorePath, playwrightEntries);
+      fs10.appendFileSync(gitignorePath, playwrightEntries);
       console.log("  \u2713 Updated .gitignore");
     }
   } else {
-    fs9.writeFileSync(gitignorePath, playwrightEntries, "utf-8");
+    fs10.writeFileSync(gitignorePath, playwrightEntries, "utf-8");
     console.log("  \u2713 Created .gitignore");
   }
 }
 async function createPackageJson(targetDir, projectName) {
-  const packageJsonPath = path10.join(targetDir, "package.json");
+  const packageJsonPath = path11.join(targetDir, "package.json");
   const recommendedDeps = {
     "@playwright/test": "^1.48.0",
     "@types/node": "^20.0.0",
@@ -8155,7 +8086,7 @@ async function createPackageJson(targetDir, projectName) {
     eslint: "^8.56.0",
     prettier: "^3.1.0"
   };
-  if (!fs9.existsSync(packageJsonPath)) {
+  if (!fs10.existsSync(packageJsonPath)) {
     const packageJson2 = {
       name: projectName,
       version: "1.0.0",
@@ -8169,11 +8100,11 @@ async function createPackageJson(targetDir, projectName) {
       keywords: ["testing", "playwright", "automation", "e2e"],
       devDependencies: recommendedDeps
     };
-    fs9.writeFileSync(packageJsonPath, JSON.stringify(packageJson2, null, 2) + "\n", "utf-8");
+    fs10.writeFileSync(packageJsonPath, JSON.stringify(packageJson2, null, 2) + "\n", "utf-8");
     console.log("  \u2713 Created package.json");
     return true;
   } else {
-    const existing = JSON.parse(fs9.readFileSync(packageJsonPath, "utf-8"));
+    const existing = JSON.parse(fs10.readFileSync(packageJsonPath, "utf-8"));
     existing.devDependencies = existing.devDependencies || {};
     let addedCount = 0;
     const addedPackages = [];
@@ -8185,7 +8116,7 @@ async function createPackageJson(targetDir, projectName) {
       }
     }
     if (addedCount > 0) {
-      fs9.writeFileSync(packageJsonPath, JSON.stringify(existing, null, 2) + "\n", "utf-8");
+      fs10.writeFileSync(packageJsonPath, JSON.stringify(existing, null, 2) + "\n", "utf-8");
       console.log(`  \u2713 Added ${addedCount} missing dependencies to package.json`);
       console.log(`    ${addedPackages.join(", ")}`);
       return true;
@@ -8212,18 +8143,18 @@ async function installDependencies(targetDir) {
   }
 }
 function detectPackageManager(targetDir) {
-  if (fs9.existsSync(path10.join(targetDir, "pnpm-lock.yaml"))) {
+  if (fs10.existsSync(path11.join(targetDir, "pnpm-lock.yaml"))) {
     return "pnpm";
   }
-  if (fs9.existsSync(path10.join(targetDir, "yarn.lock"))) {
+  if (fs10.existsSync(path11.join(targetDir, "yarn.lock"))) {
     return "yarn";
   }
   return "npm";
 }
 function isPlaywrightScaffolded(targetDir) {
-  const playwrightConfig = path10.join(targetDir, "playwright.config.ts");
-  const testsDir = path10.join(targetDir, "tests");
-  return fs9.existsSync(playwrightConfig) && fs9.existsSync(testsDir);
+  const playwrightConfig = path11.join(targetDir, "playwright.config.ts");
+  const testsDir = path11.join(targetDir, "tests");
+  return fs10.existsSync(playwrightConfig) && fs10.existsSync(testsDir);
 }
 
 // src/cli/commands/setup.ts
@@ -8284,7 +8215,7 @@ async function firstTimeSetup(cliSubagents) {
 `));
   let spinner = (0, import_ora2.default)("Creating project structure").start();
   await createProjectStructure(tool);
-  const toolDirName = path11.dirname(toolProfile.commandsDir);
+  const toolDirName = path12.dirname(toolProfile.commandsDir);
   spinner.succeed(import_chalk2.default.green(`Created .bugzy/ and ${toolDirName}/ directories`));
   const subagents = {};
   if (cliSubagents) {
@@ -8374,7 +8305,7 @@ async function firstTimeSetup(cliSubagents) {
     }
   }
   spinner = (0, import_ora2.default)("Saving configuration").start();
-  const projectName = path11.basename(process.cwd());
+  const projectName = path12.basename(process.cwd());
   const config = createDefaultConfig(projectName, tool);
   config.subagents = subagents;
   saveConfig(config);
@@ -8582,6 +8513,11 @@ async function regenerateAll(subagents, tool = DEFAULT_TOOL) {
     spinner.succeed(import_chalk2.default.green("MCP configuration ready"));
     await setupCodexMCP(mcpServers);
   }
+  if (tool === "claude-code") {
+    spinner = (0, import_ora2.default)("Generating settings").start();
+    await generateSettings(subagents, tool);
+    spinner.succeed(import_chalk2.default.green("Generated .claude/settings.json (hooks, permissions)"));
+  }
   spinner = (0, import_ora2.default)("Creating environment files").start();
   await generateEnvExample(mcpServers);
   spinner.succeed(import_chalk2.default.green("Created .env and .env.example"));
@@ -8600,7 +8536,7 @@ async function setupCodexMCP(mcpServers) {
       const { args } = buildCodexMCPCommand(serverName);
       (0, import_child_process4.execSync)(["codex", ...args].join(" "), {
         stdio: "pipe",
-        env: { ...process.env, CODEX_HOME: path11.join(process.cwd(), ".codex") }
+        env: { ...process.env, CODEX_HOME: path12.join(process.cwd(), ".codex") }
       });
       spinner.succeed(import_chalk2.default.green(`Configured ${serverName}`));
     } catch (error) {