@link-assistant/hive-mind 0.51.21 → 0.52.1

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @link-assistant/hive-mind
 
+## 0.52.1
+
+### Patch Changes
+
+- 1a4f1a2: Reduce Telegram messages by updating instead of sending new ones
+
+  The `/solve` and `/hive` commands now update the initial "Starting..." message with the success/error result instead of sending a separate message. This follows the same pattern already used by the `/limits` command.
+
+  **Before:** Two separate messages per command
+  **After:** Single message that gets updated with the result
+
+## 0.52.0
+
+### Minor Changes
+
+- b280bcc: Add `--prompt-playwright-mcp` flag to control Playwright MCP hints in system prompt
+
+  Users can now explicitly control whether Playwright MCP browser automation hints appear in the AI's system prompt:
+  - Use `--no-prompt-playwright-mcp` to disable hints even when Playwright MCP is installed
+  - Use `--prompt-playwright-mcp` to explicitly enable hints
+  - Omit the flag to keep the default auto-detection behavior
+
 ## 0.51.21
 
 ### Patch Changes

package/README.md

@@ -301,100 +301,54 @@ review --repo owner/repo --pr 456
 
 ```bash
 solve <issue-url> [options]
-
-  --model, -m           Model (sonnet, opus for claude; grok-code-fast-1, gpt4o for opencode; gpt5, gpt5-codex, o3 for codex; grok, sonnet, haiku for agent)
-                        [default: sonnet for claude, grok-code-fast-1 for opencode, gpt-5 for codex, grok-code-fast-1 for agent]
-  --tool                AI tool (claude, opencode, codex, agent)    [default: claude]
-  --fork, -f            Fork repo if no write access         [default: false]
-  --auto-fork           Automatically fork public repos without write access (fails for private)
-                        [default: true]
-  --base-branch, -b     Target branch for PR                 [default: repo default]
-  --resume, -r          Resume from session ID
-  --verbose, -v         Enable verbose logging               [default: false]
-  --dry-run, -n         Prepare only, don't execute          [default: false]
-  --only-prepare-command  Only prepare and print the command [default: false]
-  --skip-tool-check     Skip tool connection check (use --no-tool-check to disable)
-                        [default: false]
-  --auto-pull-request-creation  Create draft PR before execution [default: true]
-  --attach-logs         Attach logs to PR (⚠️ sensitive)    [default: false]
-  --auto-close-pull-request-on-fail  Close PR on fail        [default: false]
-  --auto-continue       Continue with existing PR when issue URL is provided
-                        [default: true]
-  --auto-continue-limit, -c  Auto-continue when limit resets [default: false]
-  --auto-resume-on-errors  Auto-resume on network errors (503, etc.)
-                        [default: false]
-  --auto-continue-only-on-new-comments  Fail if no new comments
-                        [default: false]
-  --auto-commit-uncommitted-changes  Auto-commit changes    [default: false]
-  --auto-merge-default-branch-to-pull-request-branch  Merge default branch to PR branch
-                        (only in continue mode) [default: false]
-  --allow-fork-divergence-resolution-using-force-push-with-lease
-                        Allow force-push with --force-with-lease when fork diverges
-                        (DANGEROUS: can overwrite fork history) [default: false]
-  --prefix-fork-name-with-owner-name  Prefix fork name with owner (owner-repo)
-                        Useful for forking repos with same name from different owners
-                        [default: true]
-  --continue-only-on-feedback  Only continue if feedback detected
-                        [default: false]
-  --watch, -w           Monitor for feedback and auto-restart [default: false]
-  --watch-interval      Feedback check interval (seconds)    [default: 60]
-  --min-disk-space      Minimum disk space in MB             [default: 500]
-  --log-dir, -l         Directory for log files              [default: cwd]
-  --think               Thinking level (low, medium, high, max)  [optional]
-  --sentry              Enable Sentry error tracking (use --no-sentry to disable)
-                        [default: true]
-  --auto-cleanup        Delete temp directory on completion
-                        [default: true for private repos, false for public repos]
-  --version             Show version number
-  --help, -h            Show help
 ```
 
+**Most frequently used options:**
+
+| Option    | Alias | Description                             | Default |
+| --------- | ----- | --------------------------------------- | ------- |
+| `--model` | `-m`  | AI model to use (sonnet, opus, haiku)   | sonnet  |
+| `--think` |       | Thinking level (low, medium, high, max) | -       |
+
+**Other useful options:**
+
+| Option          | Alias | Description                                      | Default |
+| --------------- | ----- | ------------------------------------------------ | ------- |
+| `--tool`        |       | AI tool (claude, opencode, codex, agent)         | claude  |
+| `--verbose`     | `-v`  | Enable verbose logging                           | false   |
+| `--attach-logs` |       | Attach logs to PR (⚠️ may expose sensitive data) | false   |
+| `--help`        | `-h`  | Show all available options                       | -       |
+
+> **📖 Full options list**: See [docs/CONFIGURATION.md](./docs/CONFIGURATION.md#solve-options) for all available options including forking, auto-continue, watch mode, and experimental features.
+
 ## 🔧 hive Options
 
 ```bash
 hive <github-url> [options]
-
-  --monitor-tag, -t     Label to monitor                     [default: "help wanted"]
-  --all-issues, -a      Monitor all issues (ignore labels)   [default: false]
-  --skip-issues-with-prs, -s  Skip issues with existing PRs [default: false]
-  --concurrency, -c     Parallel workers                     [default: 2]
-  --pull-requests-per-issue, -p  Number of PRs per issue    [default: 1]
-  --model, -m           Model (opus, sonnet for claude; grok-code-fast-1, gpt4o for opencode; gpt5, gpt5-codex, o3 for codex; grok, sonnet, haiku for agent)
-                        [default: sonnet for claude, grok-code-fast-1 for opencode, gpt-5 for codex, grok-code-fast-1 for agent]
-  --tool                AI tool (claude, opencode, codex, agent)    [default: claude]
-  --interval, -i        Poll interval (seconds)              [default: 300]
-  --max-issues          Limit processed issues               [default: 0 (unlimited)]
-  --once                Single run (don't monitor)           [default: false]
-  --dry-run             List issues without processing       [default: false]
-  --skip-tool-check     Skip tool connection check (use --no-tool-check to disable)
-                        [default: false]
-  --verbose, -v         Enable verbose logging               [default: false]
-  --min-disk-space      Minimum disk space in MB             [default: 500]
-  --auto-cleanup        Clean /tmp/* /var/tmp/* on success   [default: false]
-  --fork, -f            Fork repos if no write access        [default: false]
-  --auto-fork           Automatically fork public repos without write access
-                        [default: true]
-  --attach-logs         Attach logs to PRs (⚠️ sensitive)   [default: false]
-  --project-number, -pn  GitHub Project number to monitor
-  --project-owner, -po  GitHub Project owner (org or user)
-  --project-status, -ps  Project status column to monitor    [default: "Ready"]
-  --project-mode, -pm   Enable project-based monitoring      [default: false]
-  --youtrack-mode       Enable YouTrack mode instead of GitHub  [default: false]
-  --youtrack-stage      Override YouTrack stage to monitor
-  --youtrack-project    Override YouTrack project code
-  --target-branch, -tb  Target branch for pull requests      [default: repo default]
-  --log-dir, -l         Directory for log files              [default: cwd]
-  --auto-continue       Pass --auto-continue to solve for each issue
-                        [default: true]
-  --think               Thinking level (low, medium, high, max)  [optional]
-  --sentry              Enable Sentry error tracking (use --no-sentry to disable)
-                        [default: true]
-  --watch, -w           Monitor for feedback and auto-restart  [default: false]
-  --issue-order, -o     Order issues by date (asc, desc)     [default: asc]
-  --version             Show version number
-  --help, -h            Show help
 ```
 
+**Most frequently used options:**
+
+| Option         | Alias | Description                             | Default |
+| -------------- | ----- | --------------------------------------- | ------- |
+| `--model`      | `-m`  | AI model to use (sonnet, opus, haiku)   | sonnet  |
+| `--think`      |       | Thinking level (low, medium, high, max) | -       |
+| `--all-issues` | `-a`  | Monitor all issues (ignore labels)      | false   |
+| `--once`       |       | Single run (don't monitor continuously) | false   |
+
+**Other useful options:**
+
+| Option                   | Alias | Description                                       | Default |
+| ------------------------ | ----- | ------------------------------------------------- | ------- |
+| `--tool`                 |       | AI tool (claude, opencode, agent)                 | claude  |
+| `--concurrency`          | `-c`  | Number of parallel workers                        | 2       |
+| `--skip-issues-with-prs` | `-s`  | Skip issues with existing PRs                     | false   |
+| `--verbose`              | `-v`  | Enable verbose logging                            | false   |
+| `--attach-logs`          |       | Attach logs to PRs (⚠️ may expose sensitive data) | false   |
+| `--help`                 | `-h`  | Show all available options                        | -       |
+
+> **📖 Full options list**: See [docs/CONFIGURATION.md](./docs/CONFIGURATION.md#hive-options) for all available options including project monitoring, YouTrack integration, and experimental features.
+
 ## 🤖 Telegram Bot
 
 The Hive Mind includes a Telegram bot interface (SwarmMindBot) for remote command execution.
@@ -641,12 +595,14 @@ grep -E '\(cd /tmp/gh-issue-solver-[0-9]+ && claude --resume [0-9a-f-]{36}\)' hi
 
 ## 🔧 Configuration
 
-Authentication is handled through:
+**Authentication:**
 
 - `gh auth login` - GitHub CLI authentication
 - `claude-profiles` - Claude authentication profile migration to server
 
-No environment variable configuration is currently supported.
+**Environment Variables & Advanced Options:**
+
+For comprehensive configuration including environment variables, timeouts, retry limits, Telegram bot settings, YouTrack integration, and all CLI options, see [docs/CONFIGURATION.md](./docs/CONFIGURATION.md).
 
 ## 🐛 Reporting Issues
 

package/package.json

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

package/src/hive.config.lib.mjs

@@ -266,6 +266,11 @@ export const createYargsConfig = yargsInstance => {
       description: 'Create comprehensive case study documentation for the issue including logs, analysis, timeline, root cause investigation, and proposed solutions. Organizes findings into ./docs/case-studies/issue-{id}/ directory. Only supported for --tool claude.',
       default: false,
     })
+    .option('prompt-playwright-mcp', {
+      type: 'boolean',
+      description: 'Enable Playwright MCP browser automation hints in system prompt (enabled by default, only takes effect if Playwright MCP is installed). Use --no-prompt-playwright-mcp to disable. Only supported for --tool claude.',
+      default: true,
+    })
     .parserConfiguration({
       'boolean-negation': true,
       'strip-dashed': false,

package/src/hive.mjs

@@ -750,6 +750,7 @@ if (isDirectExecution) {
             const promptExploreSubAgentFlag = argv.promptExploreSubAgent ? ' --prompt-explore-sub-agent' : '';
             const promptIssueReportingFlag = argv.promptIssueReporting ? ' --prompt-issue-reporting' : '';
             const promptCaseStudiesFlag = argv.promptCaseStudies ? ' --prompt-case-studies' : '';
+            const promptPlaywrightMcpFlag = argv.promptPlaywrightMcp === true ? ' --prompt-playwright-mcp' : argv.promptPlaywrightMcp === false ? ' --no-prompt-playwright-mcp' : '';
             // Use spawn to get real-time streaming output while avoiding command-stream's automatic quote addition
             const { spawn } = await import('child_process');
 
@@ -800,9 +801,9 @@ if (isDirectExecution) {
             if (argv.promptExploreSubAgent) args.push('--prompt-explore-sub-agent');
             if (argv.promptIssueReporting) args.push('--prompt-issue-reporting');
             if (argv.promptCaseStudies) args.push('--prompt-case-studies');
-
+            if (argv.promptPlaywrightMcp !== undefined) args.push(argv.promptPlaywrightMcp ? '--prompt-playwright-mcp' : '--no-prompt-playwright-mcp');
             // Log the actual command being executed so users can investigate/reproduce
-            const command = `${solveCommand} "${issueUrl}" --model ${argv.model}${toolFlag}${forkFlag}${autoForkFlag}${verboseFlag}${attachLogsFlag}${targetBranchFlag}${logDirFlag}${dryRunFlag}${skipToolConnectionCheckFlag}${autoContinueFlag}${thinkFlag}${promptPlanSubAgentFlag}${noSentryFlag}${watchFlag}${prefixForkNameWithOwnerNameFlag}${interactiveModeFlag}${promptExploreSubAgentFlag}${promptIssueReportingFlag}${promptCaseStudiesFlag}`;
+            const command = `${solveCommand} "${issueUrl}" --model ${argv.model}${toolFlag}${forkFlag}${autoForkFlag}${verboseFlag}${attachLogsFlag}${targetBranchFlag}${logDirFlag}${dryRunFlag}${skipToolConnectionCheckFlag}${autoContinueFlag}${thinkFlag}${promptPlanSubAgentFlag}${noSentryFlag}${watchFlag}${prefixForkNameWithOwnerNameFlag}${interactiveModeFlag}${promptExploreSubAgentFlag}${promptIssueReportingFlag}${promptCaseStudiesFlag}${promptPlaywrightMcpFlag}`;
             await log(`   📋 Command: ${command}`);
 
             let exitCode = 0;

package/src/solve.config.lib.mjs

@@ -281,6 +281,11 @@ export const createYargsConfig = yargsInstance => {
         description: 'Create comprehensive case study documentation for the issue including logs, analysis, timeline, root cause investigation, and proposed solutions. Organizes findings into ./docs/case-studies/issue-{id}/ directory. Only supported for --tool claude.',
         default: false,
       })
+      .option('prompt-playwright-mcp', {
+        type: 'boolean',
+        description: 'Enable Playwright MCP browser automation hints in system prompt (enabled by default, only takes effect if Playwright MCP is installed). Use --no-prompt-playwright-mcp to disable. Only supported for --tool claude.',
+        default: true,
+      })
       .parserConfiguration({
         'boolean-negation': true,
       })

package/src/solve.mjs

@@ -828,14 +828,18 @@ try {
     // 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;
+      // If flag is true (default), check if Playwright MCP is actually available
+      if (argv.promptPlaywrightMcp) {
+        const { checkPlaywrightMcpAvailability } = claudeLib;
+        const playwrightMcpAvailable = await checkPlaywrightMcpAvailability();
+        if (playwrightMcpAvailable) {
+          await log('🎭 Playwright MCP detected - enabling browser automation hints', { verbose: true });
+        } else {
+          await log('ℹ️  Playwright MCP not detected - browser automation hints will be disabled', { verbose: true });
+          argv.promptPlaywrightMcp = false;
+        }
       } else {
-        await log('ℹ️  Playwright MCP not detected - browser automation hints will be disabled', { verbose: true });
-        argv.promptPlaywrightMcp = false;
+        await log('ℹ️  Playwright MCP explicitly disabled via --no-prompt-playwright-mcp', { verbose: true });
       }
     }
     const claudeResult = await executeClaude({

package/src/solve.watch.lib.mjs

@@ -400,15 +400,19 @@ export const watchForFeedback = async params => {
 
           // 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;
+            // If flag is true (default), check if Playwright MCP is actually available
+            if (argv.promptPlaywrightMcp) {
+              const playwrightMcpAvailable = await checkPlaywrightMcpAvailability();
+              if (playwrightMcpAvailable) {
+                await log('🎭 Playwright MCP detected - enabling browser automation hints', { verbose: true });
+              } else {
+                await log('ℹ️  Playwright MCP not detected - browser automation hints will be disabled', {
+                  verbose: true,
+                });
+                argv.promptPlaywrightMcp = false;
+              }
             } else {
-              await log('ℹ️  Playwright MCP not detected - browser automation hints will be disabled', {
-                verbose: true,
-              });
-              argv.promptPlaywrightMcp = false;
+              await log('ℹ️  Playwright MCP explicitly disabled via --no-prompt-playwright-mcp', { verbose: true });
             }
           }
 

package/src/telegram-bot.mjs

@@ -664,6 +664,35 @@ function validateGitHubUrl(args, options = {}) {
  * @param {string} text - Text to escape
  * @returns {string} Escaped text safe for Markdown parse_mode
  */
+/**
+ * Execute a start-screen command and update the initial message with the result.
+ * Used by both /solve and /hive commands to reduce code duplication.
+ *
+ * @param {Object} ctx - Telegram context
+ * @param {Object} startingMessage - The initial message to update
+ * @param {string} commandName - Command name (e.g., 'solve' or 'hive')
+ * @param {string[]} args - Command arguments
+ * @param {string} infoBlock - Info block with request details
+ */
+async function executeAndUpdateMessage(ctx, startingMessage, commandName, args, infoBlock) {
+  const result = await executeStartScreen(commandName, args);
+
+  if (result.warning) {
+    await ctx.telegram.editMessageText(startingMessage.chat.id, startingMessage.message_id, undefined, `⚠️  ${result.warning}`, { parse_mode: 'Markdown' });
+    return;
+  }
+
+  if (result.success) {
+    const sessionNameMatch = result.output.match(/session:\s*(\S+)/i) || result.output.match(/screen -r\s+(\S+)/);
+    const sessionName = sessionNameMatch ? sessionNameMatch[1] : 'unknown';
+    const response = `✅ ${commandName.charAt(0).toUpperCase() + commandName.slice(1)} command started successfully!\n\n📊 Session: \`${sessionName}\`\n\n${infoBlock}`;
+    await ctx.telegram.editMessageText(startingMessage.chat.id, startingMessage.message_id, undefined, response, { parse_mode: 'Markdown' });
+  } else {
+    const response = `❌ Error executing ${commandName} command:\n\n\`\`\`\n${result.error || result.output}\n\`\`\``;
+    await ctx.telegram.editMessageText(startingMessage.chat.id, startingMessage.message_id, undefined, response, { parse_mode: 'Markdown' });
+  }
+}
+
 /**
  * Extract GitHub issue/PR URL from message text
  * Validates that message contains exactly one GitHub issue/PR link
@@ -1044,34 +1073,15 @@ bot.command(/^solve$/i, async ctx => {
   }
 
   const requester = buildUserMention({ user: ctx.from, parseMode: 'Markdown' });
-  // Escape URL to prevent Markdown parsing errors with underscores and asterisks
   const escapedUrl = escapeMarkdown(args[0]);
-  let statusMsg = `🚀 Starting solve command...\nRequested by: ${requester}\nURL: ${escapedUrl}\nOptions: ${args.slice(1).join(' ') || 'none'}`;
+  const optionsText = args.slice(1).join(' ') || 'none';
+  let infoBlock = `Requested by: ${requester}\nURL: ${escapedUrl}\nOptions: ${optionsText}`;
   if (solveOverrides.length > 0) {
-    statusMsg += `\n🔒 Locked options: ${solveOverrides.join(' ')}`;
-  }
-  await ctx.reply(statusMsg, { parse_mode: 'Markdown', reply_to_message_id: ctx.message.message_id });
-
-  const result = await executeStartScreen('solve', args);
-
-  if (result.warning) {
-    await ctx.reply(`⚠️  ${result.warning}`, { parse_mode: 'Markdown' });
-    return;
+    infoBlock += `\n🔒 Locked options: ${solveOverrides.join(' ')}`;
   }
 
-  if (result.success) {
-    const sessionNameMatch = result.output.match(/session:\s*(\S+)/i) || result.output.match(/screen -r\s+(\S+)/);
-    const sessionName = sessionNameMatch ? sessionNameMatch[1] : 'unknown';
-
-    let response = '✅ Solve command started successfully!\n\n';
-    response += `📊 *Session:* \`${sessionName}\`\n`;
-
-    await ctx.reply(response, { parse_mode: 'Markdown', reply_to_message_id: ctx.message.message_id });
-  } else {
-    let response = '❌ Error executing solve command:\n\n';
-    response += `\`\`\`\n${result.error || result.output}\n\`\`\``;
-    await ctx.reply(response, { parse_mode: 'Markdown', reply_to_message_id: ctx.message.message_id });
-  }
+  const startingMessage = await ctx.reply(`🚀 Starting solve command...\n\n${infoBlock}`, { parse_mode: 'Markdown', reply_to_message_id: ctx.message.message_id });
+  await executeAndUpdateMessage(ctx, startingMessage, 'solve', args, infoBlock);
 });
 
 bot.command(/^hive$/i, async ctx => {
@@ -1198,34 +1208,15 @@ bot.command(/^hive$/i, async ctx => {
   }
 
   const requester = buildUserMention({ user: ctx.from, parseMode: 'Markdown' });
-  // Escape URL to prevent Markdown parsing errors with underscores and asterisks
   const escapedUrl = escapeMarkdown(args[0]);
-  let statusMsg = `🚀 Starting hive command...\nRequested by: ${requester}\nURL: ${escapedUrl}\nOptions: ${args.slice(1).join(' ') || 'none'}`;
+  const optionsText = args.slice(1).join(' ') || 'none';
+  let infoBlock = `Requested by: ${requester}\nURL: ${escapedUrl}\nOptions: ${optionsText}`;
   if (hiveOverrides.length > 0) {
-    statusMsg += `\n🔒 Locked options: ${hiveOverrides.join(' ')}`;
+    infoBlock += `\n🔒 Locked options: ${hiveOverrides.join(' ')}`;
   }
-  await ctx.reply(statusMsg, { parse_mode: 'Markdown', reply_to_message_id: ctx.message.message_id });
-
-  const result = await executeStartScreen('hive', args);
 
-  if (result.warning) {
-    await ctx.reply(`⚠️  ${result.warning}`, { parse_mode: 'Markdown' });
-    return;
-  }
-
-  if (result.success) {
-    const sessionNameMatch = result.output.match(/session:\s*(\S+)/i) || result.output.match(/screen -r\s+(\S+)/);
-    const sessionName = sessionNameMatch ? sessionNameMatch[1] : 'unknown';
-
-    let response = '✅ Hive command started successfully!\n\n';
-    response += `📊 *Session:* \`${sessionName}\`\n`;
-
-    await ctx.reply(response, { parse_mode: 'Markdown', reply_to_message_id: ctx.message.message_id });
-  } else {
-    let response = '❌ Error executing hive command:\n\n';
-    response += `\`\`\`\n${result.error || result.output}\n\`\`\``;
-    await ctx.reply(response, { parse_mode: 'Markdown', reply_to_message_id: ctx.message.message_id });
-  }
+  const startingMessage = await ctx.reply(`🚀 Starting hive command...\n\n${infoBlock}`, { parse_mode: 'Markdown', reply_to_message_id: ctx.message.message_id });
+  await executeAndUpdateMessage(ctx, startingMessage, 'hive', args, infoBlock);
 });
 
 // Register /top command from separate module