@bugzy-ai/bugzy 1.18.5 → 1.19.1

package/dist/cli/index.cjs

@@ -31,12 +31,12 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// node_modules/.pnpm/tsup@8.5.0_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js
+// node_modules/.pnpm/tsup@8.5.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js
 var getImportMetaUrl, importMetaUrl;
 var init_cjs_shims = __esm({
-  "node_modules/.pnpm/tsup@8.5.0_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js"() {
+  "node_modules/.pnpm/tsup@8.5.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js"() {
     "use strict";
-    getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.src || new URL("main.js", document.baseURI).href;
+    getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
     importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
   }
 });
@@ -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
@@ -2542,6 +2462,13 @@ var INTEGRATIONS = {
     integrationType: "oauth"
     // Uses Nango with API key auth for PAT
   },
+  asana: {
+    id: "asana",
+    name: "Asana",
+    provider: "asana",
+    // No requiredMCP — uses asana-mcp-server CLI (CLI tool), not MCP server
+    integrationType: "oauth"
+  },
   notion: {
     id: "notion",
     name: "Notion",
@@ -2646,6 +2573,7 @@ var SUBAGENTS = {
       INTEGRATIONS.jira,
       INTEGRATIONS["jira-server"],
       INTEGRATIONS["azure-devops"],
+      INTEGRATIONS.asana,
       INTEGRATIONS.notion,
       INTEGRATIONS.slack
     ],
@@ -2861,7 +2789,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);
@@ -4972,9 +4900,133 @@ Your memory file becomes more valuable over time:
 
 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.`;
 
-// src/subagents/templates/issue-tracker/notion.ts
+// src/subagents/templates/issue-tracker/asana.ts
 init_cjs_shims();
 var FRONTMATTER13 = {
+  name: "issue-tracker",
+  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.
+user: "3 tests failed in the checkout flow - payment validation is broken"
+assistant: "I'll use the issue-tracker agent to create Asana tasks for these failures with detailed reproduction steps and test evidence."
+<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.
+user: "Task 1234567890 has been verified on staging"
+assistant: "Let me use the issue-tracker agent to mark the task as complete and add verification comments."
+<commentary>Use the issue-tracker agent to update task status and document QA validation results.</commentary></example>`,
+  model: "sonnet",
+  color: "red"
+};
+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.
+
+**Important: CLI-First Approach**
+
+Always prefer CLI commands via Bash over MCP tool calls. The CLI produces compact output optimized for agent consumption and avoids MCP schema overhead.
+
+**Primary Interface \u2014 CLI Commands (via Bash):**
+
+- **Search tasks**: \`asana-cli task search --query "login bug" [--project GID] [--assignee GID]\`
+- **Get task details**: \`asana-cli task get <gid>\`
+- **Create task**: \`asana-cli task create --name "Bug: ..." --project GID [--description "..."] [--assignee GID] [--due YYYY-MM-DD]\`
+- **Update task**: \`asana-cli task update <gid> [--name "..."] [--completed] [--assignee GID] [--due YYYY-MM-DD]\`
+- **Add comment**: \`asana-cli task comment <gid> --body "Test evidence: ..."\`
+- **List projects**: \`asana-cli project list\`
+- **All commands**: Add \`--json\` for structured JSON output when parsing is needed
+
+**Core Responsibilities:**
+
+1. **Task Creation & Management**: Generate detailed tasks with reproduction steps, environment details, and test evidence. Include severity assessment and proper project/section assignment.
+
+2. **Duplicate Detection**: Before creating new tasks, always search for existing similar tasks to avoid duplicates and link related work.
+
+3. **Lifecycle Management**: Track task status, mark tasks complete when verified, add comments with test findings and status updates.
+
+4. ${MEMORY_READ_INSTRUCTIONS.replace(/{ROLE}/g, "issue-tracker")}
+
+   **Memory Sections for Issue Tracker (Asana)**:
+   - Asana workspace GID, project GIDs, and section mappings
+   - Recently reported tasks with their GIDs and status
+   - Search queries that work well for finding duplicates
+   - Task naming conventions and description templates
+   - Project-specific workflows and assignee mappings
+
+**Operational Workflow:**
+
+1. **Initial Check**: Always begin by reading \`.bugzy/runtime/memory/issue-tracker.md\` to load your Asana configuration and recent task history
+
+2. **Duplicate Detection**:
+   - Check memory for recently reported similar tasks
+   - Use \`asana-cli task search --query "error keywords"\` to search
+   - Look for matching names, descriptions, or error messages
+   - If duplicate found, add a comment to the existing task instead
+
+3. **Task Creation**:
+   - Use the project GID from memory
+   - Include comprehensive details: reproduction steps, expected vs actual behavior, environment
+   - Set appropriate assignee and due date when known
+   - Add test evidence and screenshots references in the description
+
+4. ${MEMORY_UPDATE_INSTRUCTIONS.replace(/{ROLE}/g, "issue-tracker")}
+
+   Specifically for issue-tracker (Asana), consider updating:
+   - **Created Tasks**: Add newly created tasks with their GIDs
+   - **Project Mappings**: Track which projects map to which areas
+   - **Search Patterns**: Save effective search queries
+   - **Assignee Mappings**: Track who handles what areas
+   - Update pattern library with new issue types
+
+**Memory File Structure** (\`.bugzy/runtime/memory/issue-tracker.md\`):
+\`\`\`markdown
+# Issue Tracker Memory
+
+## Last Updated: [timestamp]
+
+## Asana Configuration
+- Workspace GID: 12345
+- Default Project GID: 67890
+- Project: My Project
+
+## Project Mappings
+- Auth issues \u2192 Project "Auth" (GID: 11111)
+- Payment issues \u2192 Project "Payments" (GID: 22222)
+- UI issues \u2192 Project "Frontend" (GID: 33333)
+
+## Assignee Mappings
+- Auth bugs \u2192 user GID 44444
+- Payment bugs \u2192 user GID 55555
+
+## Recent Tasks (Last 30 days)
+- [Date] GID 98765: Login timeout on Chrome - Status: Open
+- [Date] GID 98766: Payment validation error - Status: Completed
+
+## Effective Search Queries
+- Login issues: --query "login" --project 11111
+- Payment bugs: --query "payment" --project 22222
+- Recent failures: --query "fail" (no project filter)
+
+## Issue Patterns
+- Timeout errors: Usually infrastructure-related
+- Validation failures: Often missing edge case handling
+- Browser-specific: Test across Chrome, Firefox, Safari
+\`\`\`
+
+**Task Creation Standards:**
+
+- Always search before creating to prevent duplicates
+- Task names: \`Bug: [Component] Short description\` or \`[Type]: Short description\`
+- Description includes: reproduction steps, expected behavior, actual behavior, environment details, test evidence
+- Set assignee when the responsible team member is known
+- Set due date for urgent/critical bugs
+
+**Quality Assurance:**
+
+- Verify project GIDs are current
+- Update task status after verification
+- Maintain accurate recent task list in memory
+- Prune old patterns that no longer apply
+
+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.`;
+
+// src/subagents/templates/issue-tracker/notion.ts
+init_cjs_shims();
+var FRONTMATTER14 = {
   name: "issue-tracker",
   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.
 user: "The submit button on the checkout page doesn't work on mobile Safari"
@@ -4986,7 +5038,7 @@ assistant: "Let me use the issue-tracker agent to update the story status to 'QA
   model: "haiku",
   color: "red"
 };
-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.
+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.
 
 **Core Responsibilities:**
 
@@ -5134,7 +5186,7 @@ You are meticulous about maintaining your memory file as a critical resource tha
 
 // src/subagents/templates/issue-tracker/slack.ts
 init_cjs_shims();
-var FRONTMATTER14 = {
+var FRONTMATTER15 = {
   name: "issue-tracker",
   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.
 user: "3 critical tests failed in the payment flow - looks like the Stripe integration is broken"
@@ -5146,7 +5198,7 @@ assistant: "Let me use the issue-tracker agent to update the story thread with Q
   model: "sonnet",
   color: "red"
 };
-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.
+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.
 
 **Core Responsibilities:**
 
@@ -5369,7 +5421,7 @@ You are focused on creating clear, organized issue threads that leverage Slack's
 
 // src/subagents/templates/changelog-historian/github.ts
 init_cjs_shims();
-var FRONTMATTER15 = {
+var FRONTMATTER16 = {
   name: "changelog-historian",
   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.
 user: "The checkout flow test is failing in staging. What changed recently?"
@@ -5381,7 +5433,7 @@ assistant: "I'll use the changelog-historian agent to compare the two releases a
   model: "haiku",
   color: "gray"
 };
-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.
+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.
 
 ## Core Responsibilities
 
@@ -5553,19 +5605,23 @@ var TEMPLATES = {
       frontmatter: FRONTMATTER12,
       content: CONTENT12
     },
-    notion: {
+    asana: {
       frontmatter: FRONTMATTER13,
       content: CONTENT13
     },
-    slack: {
+    notion: {
       frontmatter: FRONTMATTER14,
       content: CONTENT14
+    },
+    slack: {
+      frontmatter: FRONTMATTER15,
+      content: CONTENT15
     }
   },
   "changelog-historian": {
     github: {
-      frontmatter: FRONTMATTER15,
-      content: CONTENT15
+      frontmatter: FRONTMATTER16,
+      content: CONTENT16
     }
   }
 };
@@ -5596,7 +5652,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 +5743,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 +5826,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 +5848,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 +7086,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 +7262,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 +7328,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];
@@ -7749,6 +7748,9 @@ var MCP_SERVERS = {
       }
     }
   },
+  // asana: CLI-only integration — no MCP server needed.
+  // Agent uses `asana-cli task search|create|update|comment` via Bash.
+  // Package is installed globally in the container for CLI access.
   // github-modelcontextprotocol: {
   //   provider: 'github',
   //   name: 'GitHub',
@@ -7896,17 +7898,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 +8007,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 +8062,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 +8092,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 +8118,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 +8164,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 +8175,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 +8195,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 +8203,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 +8225,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 +8239,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 +8255,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 +8282,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 +8354,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 +8444,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 +8652,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 +8675,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) {