@link-assistant/hive-mind 1.7.2 → 1.9.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @link-assistant/hive-mind
 
+## 1.9.0
+
+### Minor Changes
+
+- e15f307: Add bidirectional translation between --think and --thinking-budget options for Claude Code
+
+  **Changes:**
+  - Add 'off' option to --think values: ['off', 'low', 'medium', 'high', 'max']
+  - Add --thinking-budget-claude-minimum-version option (default: 2.1.12)
+  - For Claude Code >= 2.1.12: translate --think to --thinking-budget (off→0, low→8000, medium→16000, high→24000, max→31999)
+  - For Claude Code < 2.1.12: translate --thinking-budget back to --think thinking keywords
+  - Both options now coexist and support all Claude Code versions
+
+  **Rationale:**
+  Claude Code v2.1.12+ no longer responds to thinking keywords (think, think hard, ultrathink) because extended thinking is enabled by default. The only way to control thinking budget programmatically is via MAX_THINKING_TOKENS environment variable.
+
+  Fixes #1146
+
+## 1.8.0
+
+### Minor Changes
+
+- 53e1686: Add experimental /merge command to hive-telegram-bot for sequential PR merging
+  - New `/merge <repository-url>` command to process merge queues
+  - Automatically checks/creates 'ready' label in repository
+  - Merges PRs with 'ready' label sequentially (oldest first)
+  - Waits for CI/CD completion between each merge
+  - Includes `/merge_cancel` and `/merge_status` helper commands
+  - Supports linking issues to PRs (uses minimum creation date for ordering)
+
 ## 1.7.2
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/hive-mind",
-  "version": "1.7.2",
+  "version": "1.9.0",
   "description": "AI-powered issue solver and hive mind for collaborative problem solving",
   "main": "src/hive.mjs",
   "type": "module",
@@ -68,7 +68,8 @@
     "@sentry/node": "^10.15.0",
     "@sentry/profiling-node": "^10.15.0",
     "dayjs": "^1.11.19",
-    "secretlint": "^11.2.5"
+    "secretlint": "^11.2.5",
+    "semver": "^7.7.3"
   },
   "lint-staged": {
     "*.{js,mjs,json,md}": [

package/src/claude.lib.mjs

@@ -10,7 +10,7 @@ const path = (await use('path')).default;
 // Import log from general lib
 import { log } from './lib.mjs';
 import { reportError } from './sentry.lib.mjs';
-import { timeouts, retryLimits, claudeCode, getClaudeEnv } from './config.lib.mjs';
+import { timeouts, retryLimits, claudeCode, getClaudeEnv, getThinkingLevelToTokens, getTokensToThinkingLevel, supportsThinkingBudget, DEFAULT_MAX_THINKING_BUDGET } from './config.lib.mjs';
 import { detectUsageLimit, formatUsageLimitMessage } from './usage-limit.lib.mjs';
 import { createInteractiveHandler } from './interactive-mode.lib.mjs';
 import { displayBudgetStats } from './claude.budget-stats.lib.mjs';
@@ -68,6 +68,8 @@ export const validateClaudeConnection = async (model = 'haiku-3') => {
         const versionResult = await $`timeout ${Math.floor(timeouts.claudeCli / 6000)} claude --version`;
         if (versionResult.code === 0) {
           const version = versionResult.stdout?.toString().trim();
+          // Store the version for thinking settings translation (issue #1146)
+          detectedClaudeVersion = version;
           if (retryCount === 0) {
             await log(`📦 Claude CLI version: ${version}`);
           }
@@ -219,6 +221,76 @@ export const validateClaudeConnection = async (model = 'haiku-3') => {
 // handleClaudeRuntimeSwitch is imported from ./claude.runtime-switch.lib.mjs (see issue #1141)
 // Re-export it for backwards compatibility
 export { handleClaudeRuntimeSwitch };
+
+// Store Claude Code version globally (set during validation)
+let detectedClaudeVersion = null;
+
+/**
+ * Get the detected Claude Code version
+ * @returns {string|null} The detected version or null if not yet detected
+ */
+export const getClaudeVersion = () => detectedClaudeVersion;
+
+/**
+ * Set the detected Claude Code version (called during validation)
+ * @param {string} version - The detected version string
+ */
+export const setClaudeVersion = version => {
+  detectedClaudeVersion = version;
+};
+
+/**
+ * Resolve thinking settings based on --think and --thinking-budget options
+ * Handles translation between thinking levels and token budgets based on Claude Code version
+ * @param {Object} argv - Command line arguments
+ * @param {Function} log - Logging function
+ * @returns {Object} { thinkingBudget, thinkLevel, translation, maxBudget } - Resolved settings
+ */
+export const resolveThinkingSettings = async (argv, log) => {
+  const minVersion = argv.thinkingBudgetClaudeMinimumVersion || '2.1.12';
+  const version = detectedClaudeVersion || '0.0.0'; // Assume old version if not detected
+  const isNewVersion = supportsThinkingBudget(version, minVersion);
+
+  // Get max thinking budget from argv or use default (see issue #1146)
+  const maxBudget = argv.maxThinkingBudget ?? DEFAULT_MAX_THINKING_BUDGET;
+
+  // Get thinking level mappings calculated from maxBudget
+  const thinkingLevelToTokens = getThinkingLevelToTokens(maxBudget);
+  const tokensToThinkingLevel = getTokensToThinkingLevel(maxBudget);
+
+  let thinkingBudget = argv.thinkingBudget;
+  let thinkLevel = argv.think;
+  let translation = null;
+
+  if (isNewVersion) {
+    // Claude Code >= 2.1.12: translate --think to --thinking-budget
+    if (thinkLevel !== undefined && thinkingBudget === undefined) {
+      thinkingBudget = thinkingLevelToTokens[thinkLevel];
+      translation = `--think ${thinkLevel} → --thinking-budget ${thinkingBudget}`;
+      if (argv.verbose) {
+        await log(`📊 Translating for Claude Code ${version} (>= ${minVersion}):`, { verbose: true });
+        await log(`   ${translation}`, { verbose: true });
+        if (maxBudget !== DEFAULT_MAX_THINKING_BUDGET) {
+          await log(`   Using custom --max-thinking-budget: ${maxBudget}`, { verbose: true });
+        }
+      }
+    }
+  } else {
+    // Claude Code < 2.1.12: translate --thinking-budget to --think keywords
+    if (thinkingBudget !== undefined && thinkLevel === undefined) {
+      thinkLevel = tokensToThinkingLevel(thinkingBudget);
+      translation = `--thinking-budget ${thinkingBudget} → --think ${thinkLevel}`;
+      if (argv.verbose) {
+        await log(`📊 Translating for Claude Code ${version} (< ${minVersion}):`, { verbose: true });
+        await log(`   ${translation}`, { verbose: true });
+      }
+      // Clear thinkingBudget since old versions don't support it
+      thinkingBudget = undefined;
+    }
+  }
+
+  return { thinkingBudget, thinkLevel, translation, isNewVersion, maxBudget };
+};
 /**
  * Check if Playwright MCP is available and connected to Claude
  * @returns {Promise<boolean>} True if Playwright MCP is available, false otherwise
@@ -805,8 +877,20 @@ export const executeClaudeCommand = async params => {
       await log('', { verbose: true });
     }
     try {
-      const claudeEnv = getClaudeEnv(); // Set CLAUDE_CODE_MAX_OUTPUT_TOKENS (see issue #1076)
+      // Resolve thinking settings (handles translation between --think and --thinking-budget based on Claude version)
+      // See issue #1146 for details on thinking budget translation
+      const { thinkingBudget: resolvedThinkingBudget, thinkLevel, isNewVersion } = await resolveThinkingSettings(argv, log);
+
+      // Set CLAUDE_CODE_MAX_OUTPUT_TOKENS (see issue #1076) and optionally MAX_THINKING_TOKENS (see issue #1146)
+      const claudeEnv = getClaudeEnv({ thinkingBudget: resolvedThinkingBudget });
       if (argv.verbose) await log(`📊 CLAUDE_CODE_MAX_OUTPUT_TOKENS: ${claudeCode.maxOutputTokens}`, { verbose: true });
+      if (resolvedThinkingBudget !== undefined) {
+        await log(`📊 MAX_THINKING_TOKENS: ${resolvedThinkingBudget}`, { verbose: true });
+      }
+      // Log thinking level for older Claude Code versions that use thinking keywords
+      if (!isNewVersion && thinkLevel) {
+        await log(`📊 Thinking level (via keywords): ${thinkLevel}`, { verbose: true });
+      }
       if (argv.resume) {
         // When resuming, pass prompt directly with -p flag. Escape double quotes for shell.
         const simpleEscapedPrompt = prompt.replace(/"/g, '\\"');
@@ -1351,4 +1435,7 @@ export default {
   executeClaudeCommand,
   checkForUncommittedChanges,
   calculateSessionTokens,
+  getClaudeVersion,
+  setClaudeVersion,
+  resolveThinkingSettings,
 };

package/src/claude.prompts.lib.mjs

@@ -63,7 +63,10 @@ export const buildUserPrompt = params => {
     promptLines.push('');
   }
 
-  // Add thinking instruction based on --think level
+  // Note: --think keywords are deprecated for Claude Code >= 2.1.12
+  // Thinking is now enabled by default with 31,999 token budget
+  // Use --thinking-budget to control MAX_THINKING_TOKENS instead
+  // Keeping keywords for backward compatibility with older Claude Code versions
   if (argv && argv.think) {
     const thinkMessages = {
       low: 'Think.',
@@ -89,7 +92,10 @@ export const buildUserPrompt = params => {
 export const buildSystemPrompt = params => {
   const { owner, repo, issueNumber, prNumber, branchName, workspaceTmpDir, argv } = params;
 
-  // Build thinking instruction based on --think level
+  // Note: --think keywords are deprecated for Claude Code >= 2.1.12
+  // Thinking is now enabled by default with 31,999 token budget
+  // Use --thinking-budget to control MAX_THINKING_TOKENS instead
+  // Keeping keywords for backward compatibility with older Claude Code versions
   let thinkLine = '';
   if (argv && argv.think) {
     const thinkMessages = {

package/src/config.lib.mjs

@@ -20,6 +20,9 @@ if (typeof globalThis.use === 'undefined') {
 
 const getenv = await use('getenv');
 
+// Use semver package for version comparison (see issue #1146)
+import semver from 'semver';
+
 // Import lino for parsing Links Notation format
 const { lino } = await import('./lino.lib.mjs');
 
@@ -89,8 +92,80 @@ export const claudeCode = {
   maxOutputTokens: parseIntWithDefault('CLAUDE_CODE_MAX_OUTPUT_TOKENS', parseIntWithDefault('HIVE_MIND_CLAUDE_CODE_MAX_OUTPUT_TOKENS', 64000)),
 };
 
+// Default max thinking budget for Claude Code (see issue #1146)
+// This is the default value used by Claude Code when extended thinking is enabled
+// Can be overridden via --max-thinking-budget option
+export const DEFAULT_MAX_THINKING_BUDGET = 31999;
+
+/**
+ * Get thinking level token values calculated from max budget
+ * Values are evenly distributed: off=0, low=max/4, medium=max/2, high=max*3/4, max=max
+ * @param {number} maxBudget - Maximum thinking budget (default: 31999)
+ * @returns {Object} Mapping of thinking levels to token values
+ */
+export const getThinkingLevelToTokens = (maxBudget = DEFAULT_MAX_THINKING_BUDGET) => ({
+  off: 0,
+  low: Math.floor(maxBudget / 4), // ~8000 for default 31999
+  medium: Math.floor(maxBudget / 2), // ~16000 for default 31999
+  high: Math.floor((maxBudget * 3) / 4), // ~24000 for default 31999
+  max: maxBudget, // 31999 by default
+});
+
+// Default thinking level to tokens mapping (using default max budget)
+export const thinkingLevelToTokens = getThinkingLevelToTokens(DEFAULT_MAX_THINKING_BUDGET);
+
+/**
+ * Get tokens to thinking level mapping function with configurable max budget
+ * Uses midpoint ranges to determine the level
+ * @param {number} maxBudget - Maximum thinking budget (default: 31999)
+ * @returns {Function} Function that converts tokens to thinking level
+ */
+export const getTokensToThinkingLevel = (maxBudget = DEFAULT_MAX_THINKING_BUDGET) => {
+  const levels = getThinkingLevelToTokens(maxBudget);
+  // Calculate midpoints between levels for range determination
+  const lowMediumMidpoint = Math.floor((levels.low + levels.medium) / 2);
+  const mediumHighMidpoint = Math.floor((levels.medium + levels.high) / 2);
+  const highMaxMidpoint = Math.floor((levels.high + levels.max) / 2);
+
+  return tokens => {
+    if (tokens === 0) return 'off';
+    if (tokens <= lowMediumMidpoint) return 'low';
+    if (tokens <= mediumHighMidpoint) return 'medium';
+    if (tokens <= highMaxMidpoint) return 'high';
+    return 'max';
+  };
+};
+
+// Default tokens to thinking level function (using default max budget)
+export const tokensToThinkingLevel = getTokensToThinkingLevel(DEFAULT_MAX_THINKING_BUDGET);
+
+// Check if a version supports thinking budget (>= minimum version)
+// Uses semver npm package for reliable version comparison (see issue #1146)
+export const supportsThinkingBudget = (version, minVersion = '2.1.12') => {
+  // Clean the version string (remove any leading 'v' and extra text)
+  const cleanVersion = semver.clean(version) || semver.coerce(version)?.version;
+  const cleanMinVersion = semver.clean(minVersion) || semver.coerce(minVersion)?.version;
+
+  if (!cleanVersion || !cleanMinVersion) {
+    // If versions can't be parsed, assume old version (doesn't support budget)
+    return false;
+  }
+
+  return semver.gte(cleanVersion, cleanMinVersion);
+};
+
 // Helper function to get Claude CLI environment with CLAUDE_CODE_MAX_OUTPUT_TOKENS set
-export const getClaudeEnv = () => ({ ...process.env, CLAUDE_CODE_MAX_OUTPUT_TOKENS: String(claudeCode.maxOutputTokens) });
+// Optionally sets MAX_THINKING_TOKENS when thinkingBudget is provided (see issue #1146)
+export const getClaudeEnv = (options = {}) => {
+  const env = { ...process.env, CLAUDE_CODE_MAX_OUTPUT_TOKENS: String(claudeCode.maxOutputTokens) };
+  // Set MAX_THINKING_TOKENS if thinkingBudget is provided
+  // This controls Claude Code's extended thinking feature (Claude Code >= 2.1.12)
+  // Default is 31999, set to 0 to disable thinking, max is 63999 for 64K output models
+  if (options.thinkingBudget !== undefined) {
+    env.MAX_THINKING_TOKENS = String(options.thinkingBudget);
+  }
+  return env;
+};
 
 // Cache TTL configurations (in milliseconds)
 // The Usage API (Claude limits) has stricter rate limiting than regular APIs
@@ -168,6 +243,23 @@ export const version = {
   default: getenv('HIVE_MIND_VERSION_DEFAULT', '0.14.3'),
 };
 
+// Merge queue configurations
+// See: https://github.com/link-assistant/hive-mind/issues/1143
+export const mergeQueue = {
+  // Maximum PRs to process in one merge session
+  // Default: 10 PRs per session
+  maxPrsPerSession: parseIntWithDefault('HIVE_MIND_MERGE_QUEUE_MAX_PRS', 10),
+  // CI/CD polling interval in milliseconds
+  // Default: 5 minutes (300000ms) - checks CI status every 5 minutes
+  ciPollIntervalMs: parseIntWithDefault('HIVE_MIND_MERGE_QUEUE_CI_POLL_INTERVAL_MS', 5 * 60 * 1000),
+  // CI/CD timeout in milliseconds
+  // Default: 7 hours (25200000ms) - maximum wait time for CI to complete
+  ciTimeoutMs: parseIntWithDefault('HIVE_MIND_MERGE_QUEUE_CI_TIMEOUT_MS', 7 * 60 * 60 * 1000),
+  // Wait time after merge before processing next PR
+  // Default: 1 minute (60000ms) - allows CI to stabilize
+  postMergeWaitMs: parseIntWithDefault('HIVE_MIND_MERGE_QUEUE_POST_MERGE_WAIT_MS', 60 * 1000),
+};
+
 // Helper function to validate configuration values
 export function validateConfig() {
   // Ensure all numeric values are valid
@@ -213,6 +305,7 @@ export function getAllConfigurations() {
     externalUrls,
     modelConfig,
     version,
+    mergeQueue,
   };
 }