@link-assistant/hive-mind 1.73.3 → 1.73.4

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @link-assistant/hive-mind
 
+## 1.73.4
+
+### Patch Changes
+
+- bfdc3fe: Add support for Claude Opus 4.8 (issue #1832). The bare `opus` alias for the `claude` tool now resolves to `claude-opus-4-8`, and the explicit `opus-4-8` / `claude-opus-4-8` aliases (plus their `[1m]` variants for the 1M-token context window) are accepted everywhere existing Opus aliases are. All earlier aliases keep working unchanged — `opus-4-7` / `claude-opus-4-7`, `opus-4-6` / `claude-opus-4-6`, `opus-4-5`, `sonnet`, `haiku`, and `opusplan` continue to map to the same model IDs as before. The `--fallback-model` default chain for the `claude` tool extends to `opus`/`opus-4-8` → `opus-4-7` → `opus-4-6`; the `--think xhigh`/`max` levels remain supported (4.8 shares Opus 4.7's effort surface and adaptive-only thinking, so Claude Code never emits `MAX_THINKING_TOKENS` for it); `--show-thinking-content` still opts into thinking output on 4.8 the same way it does on 4.7. Adds the deep case study under `docs/case-studies/issue-1832/` (covering the requirements, solution plan, and verification matrix) and `tests/test-opus-48-model-support.mjs` (175 assertions) alongside the existing 4.7 regression test. The English `docs/CONFIGURATION.md` row text is left unchanged in this PR to keep all four language siblings in sync; the case study is the authoritative user-facing documentation for the 4.8 behavior.
+
 ## 1.73.3
 
 ### Patch Changes

package/package.json

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

package/src/config.lib.mjs

@@ -177,7 +177,7 @@ export const DEFAULT_MAX_THINKING_BUDGET = 31999;
 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, updated in Issue #1238)
+ * Check if a model is Opus 4.6 or later (Issue #1221, updated in Issue #1238, Issue #1832)
  * @param {string} model - The model name or ID
  * @returns {boolean} True if the model is Opus 4.6 or later
  */
@@ -185,22 +185,22 @@ export const isOpus46OrLater = model => {
   if (!model) return false;
   const normalizedModel = model.toLowerCase();
   // Check for explicit opus-4-6 or later versions, or opusplan (Issue #1223)
-  // Note: The 'opus' alias now maps to Opus 4.7 (Issue #1620), so we also check for the alias directly
+  // Note: The 'opus' alias now maps to Opus 4.8 (Issue #1832), so we also check for the alias directly
   // opusplan uses Opus for planning, so it should get Opus-level settings
-  return normalizedModel === 'opus' || normalizedModel === 'opusplan' || normalizedModel.includes('opus-4-6') || normalizedModel.includes('opus-4-7') || normalizedModel.includes('opus-5');
+  return normalizedModel === 'opus' || normalizedModel === 'opusplan' || normalizedModel.includes('opus-4-6') || normalizedModel.includes('opus-4-7') || normalizedModel.includes('opus-4-8') || normalizedModel.includes('opus-5');
 };
 
 const isOpus47 = model => {
   if (!model) return false;
   const normalizedModel = model.toLowerCase();
-  // 'opus' alias now maps to Opus 4.7 (Issue #1620)
+  // 'opus' alias now maps to Opus 4.8 (Issue #1832), which inherits 4.7 behaviour
   // opusplan uses Opus for planning, so it gets Opus-level settings
-  return normalizedModel === 'opus' || normalizedModel === 'opusplan' || normalizedModel.includes('opus-4-7');
+  return normalizedModel === 'opus' || normalizedModel === 'opusplan' || normalizedModel.includes('opus-4-7') || normalizedModel.includes('opus-4-8');
 };
 
 /**
- * Check if a model is Opus 4.7 or later (Issue #1620)
- * These models use Opus 4.7+ adaptive thinking behavior.
+ * Check if a model is Opus 4.7 or later (Issue #1620, Issue #1832)
+ * These models use Opus 4.7+ adaptive thinking behavior (also applies to Opus 4.8).
  * @param {string} model - The model name or ID
  * @returns {boolean} True if the model is Opus 4.7 or later
  */
@@ -210,6 +210,22 @@ export const isOpus47OrLater = model => {
   return isOpus47(model) || normalizedModel.includes('opus-5');
 };
 
+/**
+ * Check if a model is Opus 4.8 or later (Issue #1832)
+ * Opus 4.8 inherits all Opus 4.7 API constraints (adaptive thinking only, no sampling
+ * params) and adds new features such as mid-conversation system messages, refusal stop
+ * details, and fast mode. These are not exposed through Claude Code today, but this
+ * helper enables finer-grained control for future wiring.
+ * @param {string} model - The model name or ID
+ * @returns {boolean} True if the model is Opus 4.8 or later
+ */
+export const isOpus48OrLater = model => {
+  if (!model) return false;
+  const normalizedModel = model.toLowerCase();
+  // 'opus' alias now maps to Opus 4.8 (Issue #1832)
+  return normalizedModel === 'opus' || normalizedModel === 'opusplan' || normalizedModel.includes('opus-4-8') || normalizedModel.includes('opus-5');
+};
+
 const isOpus45 = model => {
   if (!model) return false;
   const m = model.toLowerCase();
@@ -247,7 +263,7 @@ export const supportsEffortLevel = model => {
 
 /**
  * Check if a model supports the xhigh effort level.
- * Official docs list xhigh only for Claude Opus 4.7.
+ * Official docs list xhigh for Claude Opus 4.7 and Opus 4.8 (Issue #1832).
  * @param {string} model - The model name or ID
  * @returns {boolean} True if the model supports xhigh effort
  */
@@ -336,8 +352,10 @@ export const tokensToThinkingLevel = getTokensToThinkingLevel(DEFAULT_MAX_THINKI
 export const OPUS_46_EFFORT_LEVELS = ['low', 'medium', 'high', 'max'];
 
 /**
- * Valid effort levels for Opus 4.7 (Issue #1620)
- * Opus 4.7 supports the additional 'xhigh' level.
+ * Valid effort levels for Opus 4.7 and Opus 4.8 (Issue #1620, Issue #1832)
+ * Both models support the additional 'xhigh' level.
+ * Opus 4.8 keeps the same effort level set; the default effort level is 'high'
+ * (enforced by Claude Code itself, not by this module).
  * See: https://platform.claude.com/docs/en/build-with-claude/effort
  * @type {string[]}
  */
@@ -438,12 +456,13 @@ export const getClaudeEnv = (options = {}) => {
     MCP_TOOL_TIMEOUT: String(claudeCode.mcpToolTimeout),
   });
 
-  // Opus 4.7+ always uses adaptive thinking — MAX_THINKING_TOKENS has no effect (Issue #1620)
+  // Opus 4.7+ always uses adaptive thinking — MAX_THINKING_TOKENS has no effect (Issue #1620, Issue #1832)
+  // Opus 4.8 inherits this constraint: adaptive thinking is the only thinking mode.
   // For Opus 4.6 and earlier, MAX_THINKING_TOKENS controls extended thinking (Claude Code >= 2.1.12)
   // Default is 0 (thinking disabled) per Issue #1238.
   const opus47 = options.model && isOpus47OrLater(options.model);
   if (opus47) {
-    // Remove any inherited MAX_THINKING_TOKENS from process.env — Opus 4.7 ignores it
+    // Remove any inherited MAX_THINKING_TOKENS from process.env — Opus 4.7+ ignores it
     delete env.MAX_THINKING_TOKENS;
   } else {
     env.MAX_THINKING_TOKENS = String(options.thinkingBudget ?? 0);
@@ -467,8 +486,9 @@ export const getClaudeEnv = (options = {}) => {
     }
   }
 
-  // Opus 4.7 omits thinking content by default; opt in with --show-thinking-content (Issue #1620)
+  // Opus 4.7+ omits thinking content by default; opt in with --show-thinking-content (Issue #1620, Issue #1832)
   // Sets CLAUDE_CODE_SHOW_THINKING=1 which Claude Code uses to request display: "summarized"
+  // Applies to Opus 4.8 as well, which inherits Opus 4.7 thinking display behaviour.
   if (options.showThinkingContent) {
     env.CLAUDE_CODE_SHOW_THINKING = '1';
   }

package/src/models/index.mjs

@@ -28,23 +28,25 @@ const execFileAsync = promisify(execFile);
 // ─── MODEL DATA ──────────────────────────────────────────────────────────────
 
 // Claude models (Anthropic API)
-// Updated for Opus 4.5/4.6/4.7 and Sonnet 4.6 support (Issue #1221, Issue #1238, Issue #1329, Issue #1433, Issue #1620)
+// Updated for Opus 4.5/4.6/4.7/4.8 and Sonnet 4.6 support (Issue #1221, Issue #1238, Issue #1329, Issue #1433, Issue #1620, Issue #1832)
 export const claudeModels = {
   sonnet: 'claude-sonnet-4-6', // Sonnet 4.6 (default, Issue #1329)
-  opus: 'claude-opus-4-7', // Opus 4.7 (Issue #1620)
+  opus: 'claude-opus-4-8', // Opus 4.8 (Issue #1832)
   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
   opusplan: 'opusplan', // Special mode: Opus for planning, Sonnet for execution (Issue #1223)
   // Shorter version aliases (Issue #1221, Issue #1329 - PR comment feedback)
   'sonnet-4-6': 'claude-sonnet-4-6', // Sonnet 4.6 short alias (Issue #1329)
-  'opus-4-7': 'claude-opus-4-7', // Opus 4.7 short alias (Issue #1620)
+  'opus-4-8': 'claude-opus-4-8', // Opus 4.8 short alias (Issue #1832)
+  'opus-4-7': 'claude-opus-4-7', // Opus 4.7 short alias (backward compatibility)
   'opus-4-6': 'claude-opus-4-6', // Opus 4.6 short alias (backward compatibility)
   'opus-4-5': 'claude-opus-4-5-20251101', // Opus 4.5 short alias
   'sonnet-4-5': 'claude-sonnet-4-5-20250929', // Sonnet 4.5 short alias (backward compatibility)
   'haiku-4-5': 'claude-haiku-4-5-20251001', // Haiku 4.5 short alias
-  // Version aliases for backward compatibility (Issue #1221, Issue #1329, Issue #1620)
-  'claude-opus-4-7': 'claude-opus-4-7', // Opus 4.7 (Issue #1620)
+  // Version aliases for backward compatibility (Issue #1221, Issue #1329, Issue #1620, Issue #1832)
+  'claude-opus-4-8': 'claude-opus-4-8', // Opus 4.8 (Issue #1832)
+  'claude-opus-4-7': 'claude-opus-4-7', // Opus 4.7 (backward compatibility)
   'claude-sonnet-4-6': 'claude-sonnet-4-6', // Sonnet 4.6 (Issue #1329)
   'claude-opus-4-6': 'claude-opus-4-6', // Opus 4.6 (backward compatibility)
   'claude-opus-4-5': 'claude-opus-4-5-20251101', // Opus 4.5
@@ -175,9 +177,10 @@ export const defaultModels = {
   gemini: 'flash',
 };
 
-// Models that support 1M token context window via [1m] suffix (Issue #1221, Issue #1238, Issue #1329)
+// Models that support 1M token context window via [1m] suffix (Issue #1221, Issue #1238, Issue #1329, Issue #1832)
 // See: https://code.claude.com/docs/en/model-config
 export const MODELS_SUPPORTING_1M_CONTEXT = [
+  'claude-opus-4-8', // Opus 4.8 (Issue #1832)
   'claude-opus-4-7', // Opus 4.7 (Issue #1620)
   'claude-opus-4-6',
   'claude-opus-4-5-20251101',
@@ -186,7 +189,8 @@ export const MODELS_SUPPORTING_1M_CONTEXT = [
   'claude-sonnet-4-5',
   'sonnet', // Now maps to Sonnet 4.6 (Issue #1329)
   'sonnet-4-6', // Short alias (Issue #1329)
-  'opus', // Now maps to Opus 4.7 (Issue #1620)
+  'opus', // Now maps to Opus 4.8 (Issue #1832)
+  'opus-4-8', // Short alias (Issue #1832)
   'opus-4-7', // Short alias (Issue #1620)
   'opus-4-6', // Short alias (Issue #1221 - PR comment feedback)
   'opus-4-5', // Short alias (Issue #1238)
@@ -216,6 +220,7 @@ export const freeToBaseModelMap = {
 
 export const CLAUDE_MODELS = {
   ...claudeModels,
+  'claude-opus-4-8': 'claude-opus-4-8', // Opus 4.8 full ID (Issue #1832)
   'claude-opus-4-7': 'claude-opus-4-7', // Opus 4.7 full ID (Issue #1620)
   'claude-sonnet-4-5-20250929': 'claude-sonnet-4-5-20250929',
   'claude-opus-4-5-20251101': 'claude-opus-4-5-20251101',
@@ -989,6 +994,7 @@ export const resolveModelId = (requestedModel, tool) => {
 
 export const defaultFallbackModels = {
   claude: {
+    'claude-opus-4-8': 'opus-4-7',
     'claude-opus-4-7': 'opus-4-6',
   },
   codex: {

package/src/solve.config.lib.mjs

@@ -285,7 +285,7 @@ export const SOLVE_OPTION_DEFINITIONS = {
   },
   think: {
     type: 'string',
-    description: 'Thinking level hint. For Claude, translated to --thinking-budget for Claude Code >= 2.1.12 (off=0, low=~8000, medium=~16000, high=~24000, xhigh/max=31999) and to CLAUDE_CODE_EFFORT_LEVEL when supported. Opus 4.7 supports xhigh and max; Opus 4.6/Sonnet 4.6/Mythos support max; Opus 4.5 uses high for xhigh/max. For Codex, mapped to reasoning effort (off=none, low=low, medium=medium, high=high, xhigh/max=xhigh).',
+    description: 'Thinking level hint. For Claude, translated to --thinking-budget for Claude Code >= 2.1.12 (off=0, low=~8000, medium=~16000, high=~24000, xhigh/max=31999) and to CLAUDE_CODE_EFFORT_LEVEL when supported. Opus 4.8/4.7 support xhigh and max; Opus 4.6/Sonnet 4.6/Mythos support max; Opus 4.5 uses high for xhigh/max. For Codex, mapped to reasoning effort (off=none, low=low, medium=medium, high=high, xhigh/max=xhigh).',
     choices: ['off', 'low', 'medium', 'high', 'xhigh', 'max'],
     default: undefined,
   },
@@ -316,12 +316,12 @@ export const SOLVE_OPTION_DEFINITIONS = {
   },
   'fallback-model': {
     type: 'string',
-    description: 'Fallback model to switch to on model capacity/overload errors. When supported, retries resume the same session with this model. Defaults: claude opus/opus-4-7 -> opus-4-6; codex gpt-5.5 -> gpt-5.4; all others unset.',
+    description: 'Fallback model to switch to on model capacity/overload errors. When supported, retries resume the same session with this model. Defaults: claude opus/opus-4-8 -> opus-4-7; claude opus-4-7 -> opus-4-6; codex gpt-5.5 -> gpt-5.4; all others unset.',
     default: undefined,
   },
   'show-thinking-content': {
     type: 'boolean',
-    description: 'Show thinking content in Claude responses. Opus 4.7 omits thinking content by default; this option opts in to receive summarized thinking blocks. Disabled by default. Only affects --tool claude.',
+    description: 'Show thinking content in Claude responses. Opus 4.7+ omits thinking content by default (applies to Opus 4.8 as well); this option opts in to receive summarized thinking blocks. Disabled by default. Only affects --tool claude.',
     default: false,
   },
   'prompt-plan-sub-agent': {