@link-assistant/hive-mind 1.17.1 → 1.17.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @link-assistant/hive-mind
 
+## 1.17.2
+
+### Patch Changes
+
+- ae013b3: Default thinking budget to zero (thinking disabled by default), align Opus 4.6 max thinking budget with standard models (31999), change `opus` alias to map to Opus 4.5 by default (supports both `opus-4-5` and `opus-4-6` aliases)
+
 ## 1.17.1
 
 ### Patch Changes

package/package.json

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

package/src/claude.lib.mjs

@@ -911,23 +911,20 @@ export const executeClaudeCommand = async params => {
     try {
       // 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);
+      const { thinkingBudget: resolvedThinkingBudget, thinkLevel, isNewVersion, maxBudget } = await resolveThinkingSettings(argv, log);
 
       // Set CLAUDE_CODE_MAX_OUTPUT_TOKENS (see issue #1076), MAX_THINKING_TOKENS (see issue #1146),
-      // and MCP timeout configurations (see issue #1066)
+      // MCP timeout configurations (see issue #1066), and CLAUDE_CODE_EFFORT_LEVEL for Opus 4.6 (Issue #1238)
       // Pass model for model-specific max output tokens (Issue #1221)
-      const claudeEnv = getClaudeEnv({ thinkingBudget: resolvedThinkingBudget, model: mappedModel });
+      // Pass thinkLevel and maxBudget for Opus 4.6 effort level conversion (Issue #1238)
+      const claudeEnv = getClaudeEnv({ thinkingBudget: resolvedThinkingBudget, model: mappedModel, thinkLevel, maxBudget });
       const modelMaxOutputTokens = getMaxOutputTokensForModel(mappedModel);
       if (argv.verbose) await log(`📊 CLAUDE_CODE_MAX_OUTPUT_TOKENS: ${modelMaxOutputTokens}`, { verbose: true });
       if (argv.verbose) await log(`📊 MCP_TIMEOUT: ${claudeCode.mcpTimeout}ms (server startup)`, { verbose: true });
       if (argv.verbose) await log(`📊 MCP_TOOL_TIMEOUT: ${claudeCode.mcpToolTimeout}ms (tool execution)`, { 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 (resolvedThinkingBudget !== undefined) await log(`📊 MAX_THINKING_TOKENS: ${resolvedThinkingBudget}`, { verbose: true });
+      if (claudeEnv.CLAUDE_CODE_EFFORT_LEVEL) await log(`📊 CLAUDE_CODE_EFFORT_LEVEL: ${claudeEnv.CLAUDE_CODE_EFFORT_LEVEL}`, { verbose: true });
+      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, '\\"');

package/src/config.lib.mjs

@@ -119,21 +119,24 @@ export const claudeCode = {
 // Can be overridden via --max-thinking-budget option
 export const DEFAULT_MAX_THINKING_BUDGET = 31999;
 
-// Default max thinking budget for Opus 4.6 (Issue #1221)
-// Opus 4.6 supports higher thinking budgets due to 128K max output tokens
+// Default max thinking budget for Opus 4.6 (Issue #1221, updated in Issue #1238)
+// Aligned with standard models (31999) for consistency.
+// Opus 4.6 uses CLAUDE_CODE_EFFORT_LEVEL for thinking depth instead of MAX_THINKING_TOKENS
+// (MAX_THINKING_TOKENS is ignored for Opus 4.6 unless set to 0 to disable thinking).
 // Can be overridden via --max-thinking-budget option or HIVE_MIND_MAX_THINKING_BUDGET_OPUS_46
-export const DEFAULT_MAX_THINKING_BUDGET_OPUS_46 = parseIntWithDefault('HIVE_MIND_MAX_THINKING_BUDGET_OPUS_46', 64000);
+export const DEFAULT_MAX_THINKING_BUDGET_OPUS_46 = parseIntWithDefault('HIVE_MIND_MAX_THINKING_BUDGET_OPUS_46', 31999);
 
 /**
- * Check if a model is Opus 4.6 or later (Issue #1221)
+ * Check if a model is Opus 4.6 or later (Issue #1221, updated in Issue #1238)
  * @param {string} model - The model name or ID
  * @returns {boolean} True if the model is Opus 4.6 or later
  */
 export const isOpus46OrLater = model => {
   if (!model) return false;
   const normalizedModel = model.toLowerCase();
-  // Check for opus alias (which maps to 4.6) or explicit opus-4-6
-  return normalizedModel === 'opus' || normalizedModel.includes('opus-4-6') || normalizedModel.includes('opus-4-7') || normalizedModel.includes('opus-5');
+  // Check for explicit opus-4-6 or later versions
+  // Note: The 'opus' alias now maps to Opus 4.5 (Issue #1238), so we only check explicit version identifiers
+  return normalizedModel.includes('opus-4-6') || normalizedModel.includes('opus-4-7') || normalizedModel.includes('opus-5');
 };
 
 /**
@@ -202,6 +205,59 @@ export const getTokensToThinkingLevel = (maxBudget = DEFAULT_MAX_THINKING_BUDGET
 // Default tokens to thinking level function (using default max budget)
 export const tokensToThinkingLevel = getTokensToThinkingLevel(DEFAULT_MAX_THINKING_BUDGET);
 
+/**
+ * Valid effort levels for Opus 4.6 (Issue #1238)
+ * Opus 4.6 uses CLAUDE_CODE_EFFORT_LEVEL for thinking depth control
+ * @type {string[]}
+ */
+export const OPUS_46_EFFORT_LEVELS = ['low', 'medium', 'high'];
+
+/**
+ * Convert thinking level to Opus 4.6 effort level (Issue #1238)
+ * Opus 4.6 uses CLAUDE_CODE_EFFORT_LEVEL (low/medium/high) instead of MAX_THINKING_TOKENS
+ * @param {string|undefined} thinkLevel - The thinking level (off/low/medium/high/max)
+ * @returns {string|undefined} The effort level (low/medium/high) or undefined if thinking is off
+ */
+export const thinkLevelToEffortLevel = thinkLevel => {
+  if (!thinkLevel || thinkLevel === 'off') {
+    // No effort level when thinking is disabled
+    return undefined;
+  }
+
+  // Map hive-mind thinking levels to Opus 4.6 effort levels
+  // Note: Opus 4.6 only supports low/medium/high, not 'max'
+  // We map 'max' to 'high' as it's the highest available level
+  switch (thinkLevel) {
+    case 'low':
+      return 'low';
+    case 'medium':
+      return 'medium';
+    case 'high':
+    case 'max':
+      return 'high';
+    default:
+      return undefined;
+  }
+};
+
+/**
+ * Convert thinking budget (tokens) to Opus 4.6 effort level (Issue #1238)
+ * Uses token thresholds to determine the appropriate effort level
+ * @param {number|undefined} thinkingBudget - The thinking budget in tokens
+ * @param {number} maxBudget - Maximum thinking budget (default: 31999)
+ * @returns {string|undefined} The effort level (low/medium/high) or undefined if thinking is off
+ */
+export const thinkingBudgetToEffortLevel = (thinkingBudget, maxBudget = DEFAULT_MAX_THINKING_BUDGET) => {
+  if (thinkingBudget === undefined || thinkingBudget === 0) {
+    // No effort level when thinking is disabled
+    return undefined;
+  }
+
+  // Convert tokens to thinking level, then to effort level
+  const thinkLevel = getTokensToThinkingLevel(maxBudget)(thinkingBudget);
+  return thinkLevelToEffortLevel(thinkLevel);
+};
+
 // 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') => {
@@ -221,6 +277,7 @@ export const supportsThinkingBudget = (version, minVersion = '2.1.12') => {
 // Optionally sets MAX_THINKING_TOKENS when thinkingBudget is provided (see issue #1146)
 // Also sets MCP_TIMEOUT and MCP_TOOL_TIMEOUT for MCP tool execution (see issue #1066)
 // Supports model-specific max output tokens for Opus 4.6 (Issue #1221)
+// Sets CLAUDE_CODE_EFFORT_LEVEL for Opus 4.6 models (Issue #1238)
 export const getClaudeEnv = (options = {}) => {
   // Get max output tokens based on model (Issue #1221)
   const maxOutputTokens = options.model ? getMaxOutputTokensForModel(options.model) : claudeCode.maxOutputTokens;
@@ -235,12 +292,29 @@ export const getClaudeEnv = (options = {}) => {
     MCP_TIMEOUT: String(claudeCode.mcpTimeout),
     MCP_TOOL_TIMEOUT: String(claudeCode.mcpToolTimeout),
   };
-  // Set MAX_THINKING_TOKENS if thinkingBudget is provided
-  // This controls Claude Code's extended thinking feature (Claude Code >= 2.1.12)
-  // Default is 31999 (or 64000 for Opus 4.6), set to 0 to disable thinking
-  if (options.thinkingBudget !== undefined) {
-    env.MAX_THINKING_TOKENS = String(options.thinkingBudget);
+
+  // Set MAX_THINKING_TOKENS to control Claude Code's extended thinking feature (Claude Code >= 2.1.12)
+  // Default is 0 (thinking disabled) per Issue #1238. Set to 0 to disable thinking.
+  // Users can explicitly enable thinking via --think or --thinking-budget options.
+  env.MAX_THINKING_TOKENS = String(options.thinkingBudget ?? 0);
+
+  // For Opus 4.6+, also set CLAUDE_CODE_EFFORT_LEVEL to control thinking depth (Issue #1238)
+  // Opus 4.6 uses effort level (low/medium/high) instead of MAX_THINKING_TOKENS for thinking depth.
+  // MAX_THINKING_TOKENS is only used to disable thinking (when set to 0).
+  if (options.model && isOpus46OrLater(options.model)) {
+    // Convert thinkLevel or thinkingBudget to effort level
+    let effortLevel;
+    if (options.thinkLevel) {
+      effortLevel = thinkLevelToEffortLevel(options.thinkLevel);
+    } else if (options.thinkingBudget !== undefined && options.thinkingBudget > 0) {
+      effortLevel = thinkingBudgetToEffortLevel(options.thinkingBudget, options.maxBudget);
+    }
+
+    if (effortLevel) {
+      env.CLAUDE_CODE_EFFORT_LEVEL = effortLevel;
+    }
   }
+
   return env;
 };
 

package/src/model-mapping.lib.mjs

@@ -6,10 +6,10 @@
  */
 
 // Claude models (Anthropic API)
-// Updated for Opus 4.6 support (Issue #1221)
+// Updated for Opus 4.5/4.6 support (Issue #1221, Issue #1238)
 export const claudeModels = {
   sonnet: 'claude-sonnet-4-5-20250929', // Sonnet 4.5
-  opus: 'claude-opus-4-6', // Opus 4.6 (latest)
+  opus: 'claude-opus-4-5-20251101', // Opus 4.5 (default, Issue #1238)
   haiku: 'claude-haiku-4-5-20251001', // Haiku 4.5
   'haiku-3-5': 'claude-3-5-haiku-20241022', // Haiku 3.5
   'haiku-3': 'claude-3-haiku-20240307', // Haiku 3

package/src/model-validation.lib.mjs

@@ -15,7 +15,7 @@ import { log } from './lib.mjs';
 export const CLAUDE_MODELS = {
   // Short aliases (single word)
   sonnet: 'claude-sonnet-4-5-20250929',
-  opus: 'claude-opus-4-6', // Updated to Opus 4.6 (Issue #1221)
+  opus: 'claude-opus-4-5-20251101', // Changed to Opus 4.5 (Issue #1238)
   haiku: 'claude-haiku-4-5-20251001',
   'haiku-3-5': 'claude-3-5-haiku-20241022',
   'haiku-3': 'claude-3-haiku-20240307',
@@ -25,8 +25,8 @@ export const CLAUDE_MODELS = {
   'sonnet-4-5': 'claude-sonnet-4-5-20250929', // Sonnet 4.5 short alias
   'haiku-4-5': 'claude-haiku-4-5-20251001', // Haiku 4.5 short alias
   // Opus version aliases (Issue #1221)
-  'claude-opus-4-6': 'claude-opus-4-6', // Latest Opus
-  'claude-opus-4-5': 'claude-opus-4-5-20251101', // Backward compatibility alias
+  'claude-opus-4-6': 'claude-opus-4-6', // Opus 4.6
+  'claude-opus-4-5': 'claude-opus-4-5-20251101', // Opus 4.5
   // Sonnet version aliases
   'claude-sonnet-4-5': 'claude-sonnet-4-5-20250929',
   // Haiku version aliases
@@ -39,15 +39,17 @@ export const CLAUDE_MODELS = {
   'claude-3-haiku-20240307': 'claude-3-haiku-20240307',
 };
 
-// Models that support 1M token context window via [1m] suffix (Issue #1221)
+// Models that support 1M token context window via [1m] suffix (Issue #1221, Issue #1238)
 // See: https://code.claude.com/docs/en/model-config
 export const MODELS_SUPPORTING_1M_CONTEXT = [
   'claude-opus-4-6',
+  'claude-opus-4-5-20251101',
   'claude-sonnet-4-5-20250929',
   'claude-sonnet-4-5',
   'sonnet',
   'opus',
   'opus-4-6', // Short alias (Issue #1221 - PR comment feedback)
+  'opus-4-5', // Short alias (Issue #1238)
   'sonnet-4-5', // Short alias (Issue #1221 - PR comment feedback)
 ];
 

package/src/solve.config.lib.mjs

@@ -220,7 +220,7 @@ export const SOLVE_OPTION_DEFINITIONS = {
   },
   'thinking-budget': {
     type: 'number',
-    description: 'Thinking token budget for Claude Code (0-63999). Controls MAX_THINKING_TOKENS. Default: 31999 (Claude default). Set to 0 to disable thinking. For older Claude Code versions, translated back to --think level.',
+    description: 'Thinking token budget for Claude Code (0-31999). Controls MAX_THINKING_TOKENS. Default: 0 (thinking disabled). For older Claude Code versions, translated back to --think level.',
     default: undefined,
   },
   'thinking-budget-claude-minimum-version': {