@bugzy-ai/bugzy 1.3.0 → 1.4.0

package/dist/cli/index.js

@@ -3845,13 +3845,22 @@ async function validateProjectStructure() {
 }
 async function checkToolAvailable(command) {
   const { spawn: spawn2 } = await import("child_process");
+  const isWindows = process.platform === "win32";
+  const checkCommand = isWindows ? "where" : "which";
   return new Promise((resolve) => {
-    const proc = spawn2("which", [command]);
+    const proc = spawn2(checkCommand, [command], {
+      shell: isWindows
+      // Windows needs shell for 'where'
+    });
     proc.on("close", (code) => {
-      resolve(code === 0);
+      if (code !== 0) {
+        console.warn(`Warning: Could not verify '${command}' is installed (${checkCommand} check failed). Continuing anyway...`);
+      }
+      resolve(true);
     });
     proc.on("error", () => {
-      resolve(false);
+      console.warn(`Warning: Could not verify '${command}' is installed (${checkCommand} not available). Continuing anyway...`);
+      resolve(true);
     });
   });
 }
@@ -3904,21 +3913,8 @@ async function startSession(prompt) {
     process.exit(1);
   }
   spinner = ora(`Checking ${toolProfile.name} availability`).start();
-  const toolAvailable = await checkToolAvailable(toolProfile.cliCommand);
-  if (!toolAvailable) {
-    spinner.fail(chalk.red(`${toolProfile.name} CLI not found`));
-    console.log(chalk.yellow(`
-Please install ${toolProfile.name}:`));
-    if (tool === "claude-code") {
-      console.log(chalk.cyan("  https://claude.com/claude-code"));
-    } else if (tool === "cursor") {
-      console.log(chalk.cyan("  https://www.cursor.com/"));
-    } else if (tool === "codex") {
-      console.log(chalk.cyan("  npm install -g @openai/codex"));
-    }
-    process.exit(1);
-  }
-  spinner.succeed(chalk.green(`${toolProfile.name} CLI found`));
+  await checkToolAvailable(toolProfile.cliCommand);
+  spinner.succeed(chalk.green(`${toolProfile.name} CLI check complete`));
   spinner = ora("Loading environment variables").start();
   const envVars = loadEnvFiles();
   const envCount = Object.keys(envVars).length;
@@ -6533,8 +6529,8 @@ var SUBAGENTS = {
     description: "Automatically create and track bugs and issues",
     icon: "bot",
     integrations: [
-      INTEGRATIONS.linear,
-      INTEGRATIONS.jira,
+      // INTEGRATIONS.linear,
+      // INTEGRATIONS.jira,
       INTEGRATIONS["jira-server"],
       INTEGRATIONS.notion,
       INTEGRATIONS.slack
@@ -6548,7 +6544,10 @@ var SUBAGENTS = {
     name: "Documentation Researcher",
     description: "Search and retrieve information from your documentation",
     icon: "file-search",
-    integrations: [INTEGRATIONS.notion, INTEGRATIONS.confluence],
+    integrations: [
+      INTEGRATIONS.notion
+      // INTEGRATIONS.confluence
+    ],
     model: "sonnet",
     color: "cyan",
     version: "1.0.0"
@@ -6984,6 +6983,7 @@ var MCP_SERVERS = {
     name: "Slack",
     description: "Slack MCP server for messaging and channel operations",
     requiresCredentials: true,
+    npmPackages: ["simple-slack-mcp-server"],
     config: {
       command: "slack-mcp-server",
       args: [],
@@ -6997,6 +6997,7 @@ var MCP_SERVERS = {
     name: "Microsoft Teams",
     description: "Microsoft Teams MCP server for messaging and channel operations",
     requiresCredentials: true,
+    npmPackages: ["@bugzy-ai/teams-mcp-server"],
     config: {
       command: "teams-mcp-server",
       args: [],
@@ -7010,6 +7011,7 @@ var MCP_SERVERS = {
     name: "Playwright",
     description: "Playwright MCP server for browser automation",
     requiresCredentials: false,
+    npmPackages: ["@playwright/mcp"],
     config: {
       command: "mcp-server-playwright",
       args: [
@@ -7034,6 +7036,7 @@ var MCP_SERVERS = {
     name: "Notion",
     description: "Notion MCP server for documentation",
     requiresCredentials: true,
+    npmPackages: ["@notionhq/notion-mcp-server"],
     config: {
       command: "notion-mcp-server",
       args: [],
@@ -7047,6 +7050,7 @@ var MCP_SERVERS = {
     name: "Jira Server (On-Prem)",
     description: "Jira Server MCP via tunnel for on-premise instances",
     requiresCredentials: true,
+    npmPackages: ["@mcp-tunnel/wrapper", "@bugzy-ai/jira-mcp-server"],
     config: {
       command: "mcp-tunnel",
       args: ["--server", "jira-mcp-server"],
@@ -7240,11 +7244,13 @@ function getMCPEnvConfig(serverName) {
   const configs = {
     slack: `
 # Slack MCP Server
-# Get your token from: https://api.slack.com/apps
+# Setup guide: https://github.com/bugzy-ai/bugzy/blob/main/docs/slack-setup.md
+# Required scopes: channels:read, chat:write, chat:write.public, reactions:write
 SLACK_ACCESS_TOKEN=`,
     notion: `
 # Notion MCP Server
-# Get your token from: https://www.notion.so/my-integrations
+# Setup guide: https://github.com/bugzy-ai/bugzy/blob/main/docs/notion-setup.md
+# Requires: Internal Integration Token (ntn_* or secret_*)
 NOTION_TOKEN=`,
     linear: `
 # Linear MCP Server
@@ -7628,6 +7634,34 @@ async function firstTimeSetup(cliSubagents) {
       }
     }
   }
+  const mcpServers = getMCPServersFromSubagents(subagents);
+  const packagesToInstall = [...new Set(
+    mcpServers.flatMap((s) => MCP_SERVERS[s]?.npmPackages ?? [])
+  )];
+  if (packagesToInstall.length > 0) {
+    console.log(chalk2.cyan("\nMCP Server Packages Required:\n"));
+    packagesToInstall.forEach((pkg) => console.log(chalk2.white(`  \u2022 ${pkg}`)));
+    const { installMCP } = await inquirer.prompt([{
+      type: "confirm",
+      name: "installMCP",
+      message: "Install MCP packages globally now?",
+      default: true
+    }]);
+    if (installMCP) {
+      const spinner2 = ora2("Installing MCP packages").start();
+      try {
+        execSync3(`npm install -g ${packagesToInstall.join(" ")}`, { stdio: "pipe" });
+        spinner2.succeed(chalk2.green("MCP packages installed"));
+      } catch (e) {
+        spinner2.fail(chalk2.red("Some packages failed to install"));
+        console.log(chalk2.yellow("\nInstall manually: npm install -g " + packagesToInstall.join(" ")));
+      }
+    } else {
+      console.log(chalk2.yellow("\n\u26A0\uFE0F  MCP servers will not work until packages are installed:"));
+      console.log(chalk2.white(`   npm install -g ${packagesToInstall.join(" ")}
+`));
+    }
+  }
   spinner = ora2("Saving configuration").start();
   const projectName = path12.basename(process.cwd());
   const config = createDefaultConfig(projectName, tool);
@@ -7653,11 +7687,23 @@ async function firstTimeSetup(cliSubagents) {
     });
   }
   console.log(chalk2.green.bold("\n\u2705 Setup complete!\n"));
+  console.log(chalk2.cyan("\u{1F4CB} Project Context:"));
+  console.log(chalk2.white("   Edit .bugzy/runtime/project-context.md to help the AI understand your project:"));
+  console.log(chalk2.gray("   \u2022 Project description and tech stack"));
+  console.log(chalk2.gray("   \u2022 Team communication channels"));
+  console.log(chalk2.gray("   \u2022 Bug tracking workflow"));
+  console.log(chalk2.gray("   \u2022 Testing conventions\n"));
   console.log(chalk2.yellow("Next steps:"));
   console.log(chalk2.white("1. cp .env.example .env"));
   console.log(chalk2.white("2. Edit .env and add your API tokens"));
-  console.log(chalk2.white("3. npx playwright install (install browser binaries)"));
-  console.log(chalk2.white("4. Run:"), chalk2.cyan("bugzy"));
+  if (subagents["test-runner"]) {
+    console.log(chalk2.white("3. npx playwright install (install browser binaries)"));
+    console.log(chalk2.white("4. Edit .bugzy/runtime/project-context.md"));
+    console.log(chalk2.white("5. Run:"), chalk2.cyan("bugzy"));
+  } else {
+    console.log(chalk2.white("3. Edit .bugzy/runtime/project-context.md"));
+    console.log(chalk2.white("4. Run:"), chalk2.cyan("bugzy"));
+  }
   console.log();
 }
 async function reconfigureProject() {