@link-assistant/hive-mind 0.40.1 → 0.41.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @link-assistant/hive-mind
 
+## 0.41.0
+
+### Minor Changes
+
+- 5d193ef: Add `--prompt-general-purpose-sub-agent` flag for Claude tool to enable general-purpose sub-agent usage prompting when processing large tasks with multiple files or folders
+
+## 0.40.3
+
+### Patch Changes
+
+- f8ebd99: Make Playwright MCP usage guidelines conditional based on MCP availability
+
+  - Add `checkPlaywrightMcpAvailability()` function to detect if Playwright MCP is installed
+  - Conditionally include Playwright MCP section in Claude system prompt only when MCP is detected
+  - Integration in both main execution (solve.mjs) and watch mode (solve.watch.lib.mjs)
+  - Resolves merge conflicts from main branch
+
 ## 0.40.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/hive-mind",
-  "version": "0.40.1",
+  "version": "0.41.0",
   "description": "AI-powered issue solver and hive mind for collaborative problem solving",
   "main": "src/hive.mjs",
   "type": "module",

package/src/claude.lib.mjs

@@ -360,6 +360,33 @@ export const handleClaudeRuntimeSwitch = async (argv) => {
     process.exit(0);
   }
 };
+/**
+ * Check if Playwright MCP is available and connected to Claude
+ * @returns {Promise<boolean>} True if Playwright MCP is available, false otherwise
+ */
+export const checkPlaywrightMcpAvailability = async () => {
+  try {
+    // Try to run a simple claude command that would list MCP servers if available
+    // Use a timeout to avoid hanging if Claude is not installed
+    const result = await $`timeout 5 claude mcp list 2>&1`.catch(() => null);
+
+    if (!result || result.code !== 0) {
+      return false;
+    }
+
+    const output = result.stdout?.toString() || '';
+
+    // Check if playwright is in the list of MCP servers
+    if (output.toLowerCase().includes('playwright')) {
+      return true;
+    }
+
+    return false;
+  } catch {
+    // If any error occurs, assume Playwright MCP is not available
+    return false;
+  }
+};
 /**
  * Execute Claude with all prompts and settings
  * This is the main entry point that handles all prompt building and execution

package/src/claude.prompts.lib.mjs

@@ -144,7 +144,7 @@ Initial research.
    - When you are fixing a bug, please make sure you first find the actual root cause, do as many experiments as needed.
    - When you are fixing a bug and code does not have enough tracing/logs, add them and make sure they stay in the code, but are switched off by default.
    - When you need latest comments on pull request (sorted newest first), use appropriate GitHub API commands.
-   - When you need latest comments on issue (sorted newest first), use appropriate GitHub API commands.
+   - When you need latest comments on issue (sorted newest first), use appropriate GitHub API commands.${argv && argv.promptGeneralPurposeSubAgent ? '\n   - When the task is big and requires processing of lots of files or folders, you should use the `general-purpose` sub agents to delegate work. Each separate file or folder can be delegated to a sub agent for more efficient processing.' : ''}
 
 Solution development and testing.
    - When issue is solvable, implement code with tests.
@@ -193,7 +193,8 @@ Self review.
    - When you check your solution draft, run all tests locally.
    - When you check your solution draft, verify git status shows a clean working tree with no uncommitted changes.
    - When you compare with repo style, use gh pr diff [number].
-   - When you finalize, confirm code, tests, and description are consistent.${argv && argv.promptPlanSubAgent ? '\n\nPlan sub-agent usage.\n   - When you start working on a task, consider using the Plan sub-agent to research the codebase and create an implementation plan.\n   - When using the Plan sub-agent, you can add it as the first item in your todo list.\n   - When you delegate planning, use the Task tool with subagent_type="Plan" before starting implementation work.' : ''}`;
+   - When you finalize, confirm code, tests, and description are consistent.${argv && argv.promptPlaywrightMcp ? '\n\nPlaywright MCP usage (browser automation via mcp__playwright__* tools).\n   - When you develop frontend web applications (HTML, CSS, JavaScript, React, Vue, Angular, etc.), use Playwright MCP tools to test the UI in a real browser.\n   - When WebFetch tool fails to retrieve expected content (e.g., returns empty content, JavaScript-rendered pages, or login-protected pages), use Playwright MCP tools (browser_navigate, browser_snapshot) as a fallback for web browsing.\n   - When you need to interact with dynamic web pages that require JavaScript execution, use Playwright MCP tools.\n   - When you need to visually verify how a web page looks or take screenshots, use browser_take_screenshot from Playwright MCP.\n   - When you need to fill forms, click buttons, or perform user interactions on web pages, use Playwright MCP tools (browser_click, browser_type, browser_fill_form).\n   - When you need to test responsive design or different viewport sizes, use browser_resize from Playwright MCP.\n   - When you finish using the browser, always close it with browser_close to free resources.' : ''}${argv && argv.promptPlanSubAgent ? '\n\nPlan sub-agent usage.\n   - When you start working on a task, consider using the Plan sub-agent to research the codebase and create an implementation plan.\n   - When using the Plan sub-agent, you can add it as the first item in your todo list.\n   - When you delegate planning, use the Task tool with subagent_type="Plan" before starting implementation work.' : ''}`;
+
 };
 
 // Export all functions as default object too

package/src/hive.config.lib.mjs

@@ -246,6 +246,11 @@ export const createYargsConfig = (yargsInstance) => {
       description: 'Encourage Claude to use Explore sub-agent for codebase exploration. Only supported for --tool claude.',
       default: false
     })
+    .option('prompt-general-purpose-sub-agent', {
+      type: 'boolean',
+      description: 'Prompt AI to use general-purpose sub agents for processing large tasks with multiple files/folders. Only supported for --tool claude.',
+      default: false
+    })
     .parserConfiguration({
       'boolean-negation': true,
       'strip-dashed': false,

package/src/solve.config.lib.mjs

@@ -250,6 +250,11 @@ export const createYargsConfig = (yargsInstance) => {
       description: 'Encourage Claude to use Explore sub-agent for codebase exploration. Only supported for --tool claude.',
       default: false
     })
+    .option('prompt-general-purpose-sub-agent', {
+      type: 'boolean',
+      description: 'Prompt AI to use general-purpose sub agents for processing large tasks with multiple files/folders. Only supported for --tool claude.',
+      default: false
+    })
     .parserConfiguration({
       'boolean-negation': true
     })

package/src/solve.mjs

@@ -815,6 +815,18 @@ try {
     });
   } else {
     // Default to Claude
+    // Check for Playwright MCP availability if using Claude tool
+    if (argv.tool === 'claude' || !argv.tool) {
+      const { checkPlaywrightMcpAvailability } = claudeLib;
+      const playwrightMcpAvailable = await checkPlaywrightMcpAvailability();
+      if (playwrightMcpAvailable) {
+        await log('🎭 Playwright MCP detected - enabling browser automation hints', { verbose: true });
+        argv.promptPlaywrightMcp = true;
+      } else {
+        await log('ℹ️  Playwright MCP not detected - browser automation hints will be disabled', { verbose: true });
+        argv.promptPlaywrightMcp = false;
+      }
+    }
     const claudeResult = await executeClaude({
       issueUrl,
       issueNumber,

package/src/solve.watch.lib.mjs

@@ -403,11 +403,23 @@ export const watchForFeedback = async (params) => {
         } else {
           // Use Claude (default)
           const claudeExecLib = await import('./claude.lib.mjs');
-          const { executeClaude } = claudeExecLib;
+          const { executeClaude, checkPlaywrightMcpAvailability } = claudeExecLib;
 
           // Get claude path
           const claudePath = argv.claudePath || 'claude';
 
+          // Check for Playwright MCP availability if using Claude tool
+          if (argv.tool === 'claude' || !argv.tool) {
+            const playwrightMcpAvailable = await checkPlaywrightMcpAvailability();
+            if (playwrightMcpAvailable) {
+              await log('🎭 Playwright MCP detected - enabling browser automation hints', { verbose: true });
+              argv.promptPlaywrightMcp = true;
+            } else {
+              await log('ℹ️  Playwright MCP not detected - browser automation hints will be disabled', { verbose: true });
+              argv.promptPlaywrightMcp = false;
+            }
+          }
+
           toolResult = await executeClaude({
             issueUrl,
             issueNumber,