@link-assistant/hive-mind 1.21.3 → 1.22.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @link-assistant/hive-mind
 
+## 1.22.0
+
+### Minor Changes
+
+- c000f7b: Add `--attach-solution-summary` and `--auto-attach-solution-summary` options
+
+  This feature allows users to automatically attach the AI's result summary as a PR/issue comment:
+  - `--attach-solution-summary`: Always attach the solution summary when available
+  - `--auto-attach-solution-summary`: Only attach the summary if the AI didn't create any comments during the session
+
+  The solution summary is extracted from the JSON output stream of all AI tools (claude, agent, codex, opencode). Each tool captures the last text content from various JSON event types (text, assistant, message, result) to provide a summary of the work done.
+
+  Fixes #1263
+
+## 1.21.4
+
+### Patch Changes
+
+- ea19c72: Fix queue issues: rejection, display, and formatting
+  - Fix disk rejection not blocking queue placement when threshold exceeded
+  - Restore "used" label on progress bars when below threshold
+  - Show per-queue breakdown in /limits command
+  - Group queue items by tool and use human-readable time in /solve_queue
+
+- aa42f3a: fix: improve merge queue error handling and debugging (Issue #1269)
+  - Always log errors (not just in verbose mode) for critical merge queue failures
+  - Always notify users via Telegram when merge queue fails unexpectedly
+  - Add timeout wrapper (60s) for onStatusUpdate callback to prevent infinite blocking
+  - Add error handling for CI check failures in waitForCI loop
+  - Add comprehensive case study documentation in docs/case-studies/issue-1269/
+
 ## 1.21.3
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/hive-mind",
-  "version": "1.21.3",
+  "version": "1.22.0",
   "description": "AI-powered issue solver and hive mind for collaborative problem solving",
   "main": "src/hive.mjs",
   "type": "module",
@@ -13,7 +13,7 @@
     "hive-telegram-bot": "./src/telegram-bot.mjs"
   },
   "scripts": {
-    "test": "node tests/solve-queue.test.mjs && node tests/limits-display.test.mjs && node tests/test-usage-limit.mjs && node tests/test-telegram-message-filters.mjs && node tests/test-solve-queue-command.mjs",
+    "test": "node tests/solve-queue.test.mjs && node tests/limits-display.test.mjs && node tests/test-usage-limit.mjs && node tests/test-telegram-message-filters.mjs && node tests/test-solve-queue-command.mjs && node tests/test-queue-display-1267.mjs",
     "test:queue": "node tests/solve-queue.test.mjs",
     "test:limits-display": "node tests/limits-display.test.mjs",
     "test:usage-limit": "node tests/test-usage-limit.mjs",

package/src/agent.lib.mjs

@@ -553,6 +553,7 @@ export const executeAgentCommand = async params => {
       let limitReached = false;
       let limitResetTime = null;
       let lastMessage = '';
+      let lastTextContent = ''; // Issue #1263: Track last text content for result summary
       let fullOutput = ''; // Collect all output for error detection (kept for backward compatibility)
       // Issue #1201: Track error events detected during streaming for reliable error detection
       // Post-hoc detection on fullOutput can miss errors if NDJSON lines get concatenated without newlines
@@ -613,6 +614,33 @@ export const executeAgentCommand = async params => {
                 streamingErrorMessage = data.message || data.error || line.substring(0, 100);
                 await log(`⚠️  Error event detected in stream: ${streamingErrorMessage}`, { level: 'warning' });
               }
+              // Issue #1263: Track text content for result summary
+              // Agent outputs text via 'text', 'assistant', or 'message' type events
+              if (data.type === 'text' && data.text) {
+                lastTextContent = data.text;
+              } else if (data.type === 'assistant' && data.message?.content) {
+                // Extract text from assistant message content
+                const content = Array.isArray(data.message.content) ? data.message.content : [data.message.content];
+                for (const item of content) {
+                  if (item.type === 'text' && item.text) {
+                    lastTextContent = item.text;
+                  }
+                }
+              } else if (data.type === 'message' && data.content) {
+                // Direct message content
+                if (typeof data.content === 'string') {
+                  lastTextContent = data.content;
+                } else if (Array.isArray(data.content)) {
+                  for (const item of data.content) {
+                    if (item.type === 'text' && item.text) {
+                      lastTextContent = item.text;
+                    }
+                  }
+                }
+              } else if (data.type === 'result' && data.result) {
+                // Explicit result message (like Claude outputs)
+                lastTextContent = data.result;
+              }
             } catch {
               // Not JSON - log as plain text
               await log(line);
@@ -647,6 +675,29 @@ export const executeAgentCommand = async params => {
                   streamingErrorMessage = stderrData.message || stderrData.error || stderrLine.substring(0, 100);
                   await log(`⚠️  Error event detected in stream: ${streamingErrorMessage}`, { level: 'warning' });
                 }
+                // Issue #1263: Track text content for result summary (stderr)
+                if (stderrData.type === 'text' && stderrData.text) {
+                  lastTextContent = stderrData.text;
+                } else if (stderrData.type === 'assistant' && stderrData.message?.content) {
+                  const content = Array.isArray(stderrData.message.content) ? stderrData.message.content : [stderrData.message.content];
+                  for (const item of content) {
+                    if (item.type === 'text' && item.text) {
+                      lastTextContent = item.text;
+                    }
+                  }
+                } else if (stderrData.type === 'message' && stderrData.content) {
+                  if (typeof stderrData.content === 'string') {
+                    lastTextContent = stderrData.content;
+                  } else if (Array.isArray(stderrData.content)) {
+                    for (const item of stderrData.content) {
+                      if (item.type === 'text' && item.text) {
+                        lastTextContent = item.text;
+                      }
+                    }
+                  }
+                } else if (stderrData.type === 'result' && stderrData.result) {
+                  lastTextContent = stderrData.result;
+                }
               } catch {
                 // Not JSON - log as plain text
                 await log(stderrLine);
@@ -814,6 +865,7 @@ export const executeAgentCommand = async params => {
           tokenUsage,
           pricingInfo,
           publicPricingEstimate: pricingInfo.totalCostUSD,
+          resultSummary: lastTextContent || null, // Issue #1263: Use last text content from JSON output stream
         };
       }
 
@@ -867,6 +919,11 @@ export const executeAgentCommand = async params => {
         }
       }
 
+      // Issue #1263: Log if result summary was captured
+      if (lastTextContent) {
+        await log('📝 Captured result summary from Agent output', { verbose: true });
+      }
+
       return {
         success: true,
         sessionId,
@@ -875,6 +932,7 @@ export const executeAgentCommand = async params => {
         tokenUsage,
         pricingInfo,
         publicPricingEstimate: pricingInfo.totalCostUSD,
+        resultSummary: lastTextContent || null, // Issue #1263: Use last text content from JSON output stream
       };
     } catch (error) {
       reportError(error, {
@@ -893,6 +951,7 @@ export const executeAgentCommand = async params => {
         tokenUsage: null,
         pricingInfo: null,
         publicPricingEstimate: null,
+        resultSummary: null, // Issue #1263: No result summary available on error
       };
     }
   };

package/src/claude.lib.mjs

@@ -861,6 +861,7 @@ export const executeClaudeCommand = async params => {
     let stderrErrors = [];
     let anthropicTotalCostUSD = null; // Capture Anthropic's official total_cost_usd from result
     let errorDuringExecution = false; // Issue #1088: Track if error_during_execution subtype occurred
+    let resultSummary = null; // Issue #1263: Capture AI result summary for --attach-solution-summary
 
     // Create interactive mode handler if enabled
     let interactiveHandler = null;
@@ -901,12 +902,10 @@ export const executeClaudeCommand = async params => {
       await log('---BEGIN USER PROMPT---', { verbose: true });
       await log(prompt, { verbose: true });
       await log('---END USER PROMPT---', { verbose: true });
-      await log('', { verbose: true });
       await log('📋 System prompt:', { verbose: true });
       await log('---BEGIN SYSTEM PROMPT---', { verbose: true });
       await log(systemPrompt, { verbose: true });
       await log('---END SYSTEM PROMPT---', { verbose: true });
-      await log('', { verbose: true });
     }
     try {
       // Resolve thinking settings (handles translation between --think and --thinking-budget based on Claude version)
@@ -1001,6 +1000,12 @@ export const executeClaudeCommand = async params => {
                 } else if (data.total_cost_usd !== undefined && data.total_cost_usd !== null) {
                   await log(`💰 Anthropic cost from ${data.subtype || 'unknown'} result ignored: $${data.total_cost_usd.toFixed(6)}`, { verbose: true });
                 }
+                // Issue #1263: Extract result summary for --attach-solution-summary and --auto-attach-solution-summary
+                // The result field contains the AI's summary of the work done
+                if (data.subtype === 'success' && data.result && typeof data.result === 'string') {
+                  resultSummary = data.result;
+                  await log('📝 Captured result summary from Claude output', { verbose: true });
+                }
                 if (data.is_error === true) {
                   lastMessage = data.result || JSON.stringify(data);
                   const subtype = data.subtype || 'unknown';
@@ -1067,8 +1072,7 @@ export const executeClaudeCommand = async params => {
                 const termsAcceptancePattern = /\[ACTION REQUIRED\].*terms|must run.*claude.*review.*terms/i;
                 if (termsAcceptancePattern.test(line)) {
                   commandFailed = true;
-                  await log('\n❌ Claude Code requires terms acceptance - please run `claude` interactively to accept the updated terms', { level: 'error' });
-                  await log('   This is not an error in your code, but Claude CLI needs human interaction.', { level: 'error' });
+                  await log('\n❌ Claude Code requires terms acceptance - please run `claude` interactively to accept the updated terms\n   This is not an error in your code, but Claude CLI needs human interaction.', { level: 'error' });
                 }
               }
             }
@@ -1125,8 +1129,7 @@ export const executeClaudeCommand = async params => {
         // Specifically detect "command not found" via exit code 127
         if (resultExitCode === 127 && !commandFailed) {
           commandFailed = true;
-          await log(`\n❌ Command not found (exit code 127) - "${claudePath}" is not installed or not in PATH`, { level: 'error' });
-          await log('   Please ensure Claude CLI is installed: npm install -g @anthropic-ai/claude-code', { level: 'error' });
+          await log(`\n❌ Command not found (exit code 127) - "${claudePath}" is not installed or not in PATH\n   Please ensure Claude CLI is installed: npm install -g @anthropic-ai/claude-code`, { level: 'error' });
         }
       }
 
@@ -1151,8 +1154,7 @@ export const executeClaudeCommand = async params => {
           retryCount++;
           return await executeWithRetry();
         } else {
-          await log(`\n\n❌ API overload error persisted after ${maxRetries} retries`, { level: 'error' });
-          await log('   The API appears to be heavily loaded. Please try again later.', { level: 'error' });
+          await log(`\n\n❌ API overload error persisted after ${maxRetries} retries\n   The API appears to be heavily loaded. Please try again later.`, { level: 'error' });
           return {
             success: false,
             sessionId,
@@ -1162,6 +1164,7 @@ export const executeClaudeCommand = async params => {
             messageCount,
             toolUseCount,
             anthropicTotalCostUSD, // Issue #1104: Include cost even on failure
+            resultSummary, // Issue #1263: Include result summary
           };
         }
       }
@@ -1196,11 +1199,7 @@ export const executeClaudeCommand = async params => {
           retryCount++;
           return await executeWithRetry();
         } else {
-          await log(`\n\n❌ 503 network error persisted after ${retryLimits.max503Retries} retries`, {
-            level: 'error',
-          });
-          await log('   The Anthropic API appears to be experiencing network issues.', { level: 'error' });
-          await log('   Please try again later or check https://status.anthropic.com/', { level: 'error' });
+          await log(`\n\n❌ 503 network error persisted after ${retryLimits.max503Retries} retries\n   The Anthropic API appears to be experiencing network issues.\n   Please try again later or check https://status.anthropic.com/`, { level: 'error' });
           return {
             success: false,
             sessionId,
@@ -1211,6 +1210,7 @@ export const executeClaudeCommand = async params => {
             toolUseCount,
             is503Error: true,
             anthropicTotalCostUSD, // Issue #1104: Include cost even on failure
+            resultSummary, // Issue #1263: Include result summary
           };
         }
       }
@@ -1265,11 +1265,11 @@ export const executeClaudeCommand = async params => {
       // See: docs/dependencies-research/claude-code-issues/README.md for full details
       if (!commandFailed && stderrErrors.length > 0 && messageCount === 0 && toolUseCount === 0) {
         commandFailed = true;
-        await log('\n\n❌ Command failed: No messages processed and errors detected in stderr', { level: 'error' });
-        await log('Stderr errors:', { level: 'error' });
-        for (const err of stderrErrors.slice(0, 5)) {
-          await log(`   ${err.substring(0, 200)}`, { level: 'error' });
-        }
+        const errorsPreview = stderrErrors
+          .slice(0, 5)
+          .map(e => `   ${e.substring(0, 200)}`)
+          .join('\n');
+        await log(`\n\n❌ Command failed: No messages processed and errors detected in stderr\nStderr errors:\n${errorsPreview}`, { level: 'error' });
       }
       if (commandFailed) {
         // Take resource snapshot after failure
@@ -1277,8 +1277,6 @@ export const executeClaudeCommand = async params => {
         await log('\n📈 System resources after execution:', { verbose: true });
         await log(`   Memory: ${resourcesAfter.memory.split('\n')[1]}`, { verbose: true });
         await log(`   Load: ${resourcesAfter.load}`, { verbose: true });
-        // Log attachment will be handled by solve.mjs when it receives success=false
-        await log('', { verbose: true });
         await showResumeCommand(sessionId, tempDir, claudePath, argv.model, log);
         return {
           success: false,
@@ -1290,6 +1288,7 @@ export const executeClaudeCommand = async params => {
           toolUseCount,
           errorDuringExecution,
           anthropicTotalCostUSD, // Issue #1104: Include cost even on failure
+          resultSummary, // Issue #1263: Include result summary
         };
       }
       // Issue #1088: If error_during_execution occurred but command didn't fail,
@@ -1361,6 +1360,7 @@ export const executeClaudeCommand = async params => {
         toolUseCount,
         anthropicTotalCostUSD, // Pass Anthropic's official total cost
         errorDuringExecution, // Issue #1088: Track if error_during_execution subtype occurred
+        resultSummary, // Issue #1263: Include result summary for --attach-solution-summary
       };
     } catch (error) {
       reportError(error, {
@@ -1409,6 +1409,7 @@ export const executeClaudeCommand = async params => {
         messageCount,
         toolUseCount,
         anthropicTotalCostUSD, // Issue #1104: Include cost even on failure
+        resultSummary, // Issue #1263: Include result summary
       };
     }
   }; // End of executeWithRetry function

package/src/codex.lib.mjs

@@ -288,6 +288,7 @@ export const executeCodexCommand = async params => {
       let limitReached = false;
       let limitResetTime = null;
       let lastMessage = '';
+      let lastTextContent = ''; // Issue #1263: Track last text content for result summary
       let authError = false;
 
       for await (const chunk of execCommand.stream()) {
@@ -325,6 +326,31 @@ export const executeCodexCommand = async params => {
                 await log('   This error cannot be resolved by retrying.', { level: 'error' });
                 await log('   💡 Please run: codex login', { level: 'error' });
               }
+
+              // Issue #1263: Track text content for result summary
+              // Codex outputs text via 'text', 'assistant', 'message', or 'result' type events
+              if (data.type === 'text' && data.text) {
+                lastTextContent = data.text;
+              } else if (data.type === 'assistant' && data.message?.content) {
+                const content = Array.isArray(data.message.content) ? data.message.content : [data.message.content];
+                for (const item of content) {
+                  if (item.type === 'text' && item.text) {
+                    lastTextContent = item.text;
+                  }
+                }
+              } else if (data.type === 'message' && data.content) {
+                if (typeof data.content === 'string') {
+                  lastTextContent = data.content;
+                } else if (Array.isArray(data.content)) {
+                  for (const item of data.content) {
+                    if (item.type === 'text' && item.text) {
+                      lastTextContent = item.text;
+                    }
+                  }
+                }
+              } else if (data.type === 'result' && data.result) {
+                lastTextContent = data.result;
+              }
             }
           } catch {
             // Not JSON, continue
@@ -386,16 +412,23 @@ export const executeCodexCommand = async params => {
           sessionId,
           limitReached,
           limitResetTime,
+          resultSummary: lastTextContent || null, // Issue #1263: Use last text content from JSON output stream
         };
       }
 
       await log('\n\n✅ Codex command completed');
 
+      // Issue #1263: Log if result summary was captured
+      if (lastTextContent) {
+        await log('📝 Captured result summary from Codex output', { verbose: true });
+      }
+
       return {
         success: true,
         sessionId,
         limitReached,
         limitResetTime,
+        resultSummary: lastTextContent || null, // Issue #1263: Use last text content from JSON output stream
       };
     } catch (error) {
       // Don't report auth errors to Sentry as they are user configuration issues
@@ -420,6 +453,7 @@ export const executeCodexCommand = async params => {
         sessionId: null,
         limitReached: false,
         limitResetTime: null,
+        resultSummary: null, // Issue #1263: No result summary available on error
       };
     }
   };

package/src/github-merge.lib.mjs

@@ -485,15 +485,39 @@ export async function mergePullRequest(owner, repo, prNumber, options = {}, verb
  * @returns {Promise<{success: boolean, status: string, error: string|null}>}
  */
 export async function waitForCI(owner, repo, prNumber, options = {}, verbose = false) {
-  const { timeout = 30 * 60 * 1000, pollInterval = 30 * 1000, onStatusUpdate = null } = options;
+  const {
+    timeout = 30 * 60 * 1000,
+    pollInterval = 30 * 1000,
+    onStatusUpdate = null,
+    // Issue #1269: Add timeout for callback to prevent infinite blocking
+    callbackTimeout = 60 * 1000, // 1 minute max for callback
+  } = options;
 
   const startTime = Date.now();
 
   while (Date.now() - startTime < timeout) {
-    const ciStatus = await checkPRCIStatus(owner, repo, prNumber, verbose);
+    let ciStatus;
+    try {
+      ciStatus = await checkPRCIStatus(owner, repo, prNumber, verbose);
+    } catch (error) {
+      // Issue #1269: Log and continue on CI check errors instead of crashing
+      console.error(`[ERROR] /merge: Error checking CI status for PR #${prNumber}: ${error.message}`);
+      verbose && console.error(`[VERBOSE] /merge: CI check error details:`, error);
+      // Wait and retry
+      await new Promise(resolve => setTimeout(resolve, pollInterval));
+      continue;
+    }
 
     if (onStatusUpdate) {
-      await onStatusUpdate(ciStatus);
+      // Issue #1269: Wrap callback with timeout to prevent infinite blocking
+      try {
+        await Promise.race([onStatusUpdate(ciStatus), new Promise((_, reject) => setTimeout(() => reject(new Error(`Callback timeout after ${callbackTimeout}ms`)), callbackTimeout))]);
+      } catch (callbackError) {
+        // Issue #1269: Log callback errors but continue processing
+        console.error(`[ERROR] /merge: Status update callback failed for PR #${prNumber}: ${callbackError.message}`);
+        verbose && console.error(`[VERBOSE] /merge: Callback error details:`, callbackError);
+        // Continue processing even if callback fails - don't let UI issues block merging
+      }
     }
 
     if (ciStatus.status === 'success') {

package/src/limits.lib.mjs

@@ -714,11 +714,13 @@ export function formatUsageMessage(usage, diskSpace = null, githubRateLimit = nu
   if (cpuLoad) {
     message += 'CPU\n';
     const usedBar = getProgressBar(cpuLoad.usagePercentage, DISPLAY_THRESHOLDS.CPU);
-    const warning = cpuLoad.usagePercentage >= DISPLAY_THRESHOLDS.CPU ? ' ⚠️' : '';
-    message += `${usedBar} ${cpuLoad.usagePercentage}%${warning}\n`;
+    // Show 'used' label when below threshold, warning emoji when at/above threshold
+    // See: https://github.com/link-assistant/hive-mind/issues/1267
+    const suffix = cpuLoad.usagePercentage >= DISPLAY_THRESHOLDS.CPU ? ' ⚠️' : ' used';
+    message += `${usedBar} ${cpuLoad.usagePercentage}%${suffix}\n`;
     // Show cores used based on 5m load average (e.g., "0.04/6 CPU cores used" or "3/6 CPU cores used")
     // Use parseFloat to strip unnecessary trailing zeros (3.00 -> 3, 0.10 -> 0.1, 0.04 -> 0.04)
-    message += `${parseFloat(cpuLoad.loadAvg5.toFixed(2))}/${cpuLoad.cpuCount} CPU cores used\n\n`;
+    message += `${parseFloat(cpuLoad.loadAvg5.toFixed(2))}/${cpuLoad.cpuCount} CPU cores\n\n`;
   }
 
   // Memory section (if provided)
@@ -726,8 +728,8 @@ export function formatUsageMessage(usage, diskSpace = null, githubRateLimit = nu
   if (memory) {
     message += 'RAM\n';
     const usedBar = getProgressBar(memory.usedPercentage, DISPLAY_THRESHOLDS.RAM);
-    const warning = memory.usedPercentage >= DISPLAY_THRESHOLDS.RAM ? ' ⚠️' : '';
-    message += `${usedBar} ${memory.usedPercentage}%${warning}\n`;
+    const suffix = memory.usedPercentage >= DISPLAY_THRESHOLDS.RAM ? ' ⚠️' : ' used';
+    message += `${usedBar} ${memory.usedPercentage}%${suffix}\n`;
     message += `${formatBytesRange(memory.usedBytes, memory.totalBytes)}\n\n`;
   }
 
@@ -737,8 +739,8 @@ export function formatUsageMessage(usage, diskSpace = null, githubRateLimit = nu
     message += 'Disk space\n';
     // Show used percentage with progress bar and threshold marker
     const usedBar = getProgressBar(diskSpace.usedPercentage, DISPLAY_THRESHOLDS.DISK);
-    const warning = diskSpace.usedPercentage >= DISPLAY_THRESHOLDS.DISK ? ' ⚠️' : '';
-    message += `${usedBar} ${diskSpace.usedPercentage}%${warning}\n`;
+    const suffix = diskSpace.usedPercentage >= DISPLAY_THRESHOLDS.DISK ? ' ⚠️' : ' used';
+    message += `${usedBar} ${diskSpace.usedPercentage}%${suffix}\n`;
     message += `${formatBytesRange(diskSpace.usedBytes, diskSpace.totalBytes)}\n\n`;
   }
 
@@ -748,9 +750,9 @@ export function formatUsageMessage(usage, diskSpace = null, githubRateLimit = nu
     message += 'GitHub API\n';
     // Show used percentage with progress bar and threshold marker
     const usedBar = getProgressBar(githubRateLimit.usedPercentage, DISPLAY_THRESHOLDS.GITHUB_API);
-    const warning = githubRateLimit.usedPercentage >= DISPLAY_THRESHOLDS.GITHUB_API ? ' ⚠️' : '';
-    message += `${usedBar} ${githubRateLimit.usedPercentage}%${warning}\n`;
-    message += `${githubRateLimit.used}/${githubRateLimit.limit} requests used\n`;
+    const suffix = githubRateLimit.usedPercentage >= DISPLAY_THRESHOLDS.GITHUB_API ? ' ⚠️' : ' used';
+    message += `${usedBar} ${githubRateLimit.usedPercentage}%${suffix}\n`;
+    message += `${githubRateLimit.used}/${githubRateLimit.limit} requests\n`;
     if (githubRateLimit.relativeReset) {
       message += `Resets in ${githubRateLimit.relativeReset} (${githubRateLimit.resetTime})\n`;
     } else if (githubRateLimit.resetTime) {
@@ -775,8 +777,8 @@ export function formatUsageMessage(usage, diskSpace = null, githubRateLimit = nu
     // See: https://github.com/link-assistant/hive-mind/issues/1133
     const pct = Math.floor(usage.currentSession.percentage);
     const bar = getProgressBar(pct, DISPLAY_THRESHOLDS.CLAUDE_5_HOUR_SESSION);
-    const warning = pct >= DISPLAY_THRESHOLDS.CLAUDE_5_HOUR_SESSION ? ' ⚠️' : '';
-    message += `${bar} ${pct}%${warning}\n`;
+    const suffix = pct >= DISPLAY_THRESHOLDS.CLAUDE_5_HOUR_SESSION ? ' ⚠️' : ' used';
+    message += `${bar} ${pct}%${suffix}\n`;
 
     if (usage.currentSession.resetTime) {
       const relativeTime = formatRelativeTime(usage.currentSession.resetsAt);
@@ -807,8 +809,8 @@ export function formatUsageMessage(usage, diskSpace = null, githubRateLimit = nu
     // See: https://github.com/link-assistant/hive-mind/issues/1133
     const pct = Math.floor(usage.allModels.percentage);
     const bar = getProgressBar(pct, DISPLAY_THRESHOLDS.CLAUDE_WEEKLY);
-    const warning = pct >= DISPLAY_THRESHOLDS.CLAUDE_WEEKLY ? ' ⚠️' : '';
-    message += `${bar} ${pct}%${warning}\n`;
+    const suffix = pct >= DISPLAY_THRESHOLDS.CLAUDE_WEEKLY ? ' ⚠️' : ' used';
+    message += `${bar} ${pct}%${suffix}\n`;
 
     if (usage.allModels.resetTime) {
       const relativeTime = formatRelativeTime(usage.allModels.resetsAt);
@@ -839,8 +841,8 @@ export function formatUsageMessage(usage, diskSpace = null, githubRateLimit = nu
     // See: https://github.com/link-assistant/hive-mind/issues/1133
     const pct = Math.floor(usage.sonnetOnly.percentage);
     const bar = getProgressBar(pct, DISPLAY_THRESHOLDS.CLAUDE_WEEKLY);
-    const warning = pct >= DISPLAY_THRESHOLDS.CLAUDE_WEEKLY ? ' ⚠️' : '';
-    message += `${bar} ${pct}%${warning}\n`;
+    const suffix = pct >= DISPLAY_THRESHOLDS.CLAUDE_WEEKLY ? ' ⚠️' : ' used';
+    message += `${bar} ${pct}%${suffix}\n`;
 
     if (usage.sonnetOnly.resetTime) {
       const relativeTime = formatRelativeTime(usage.sonnetOnly.resetsAt);

package/src/opencode.lib.mjs

@@ -307,6 +307,7 @@ export const executeOpenCodeCommand = async params => {
       let limitReached = false;
       let limitResetTime = null;
       let lastMessage = '';
+      let lastTextContent = ''; // Issue #1263: Track last text content for result summary
       let allOutput = ''; // Collect all output for error detection
 
       for await (const chunk of execCommand.stream()) {
@@ -315,6 +316,41 @@ export const executeOpenCodeCommand = async params => {
           await log(output);
           lastMessage = output;
           allOutput += output;
+
+          // Issue #1263: Try to parse JSON output to extract text content for result summary
+          try {
+            const lines = output.split('\n');
+            for (const line of lines) {
+              if (!line.trim()) continue;
+              const data = JSON.parse(line);
+              // Track text content for result summary
+              // OpenCode outputs text via 'text', 'assistant', 'message', or 'result' type events
+              if (data.type === 'text' && data.text) {
+                lastTextContent = data.text;
+              } else if (data.type === 'assistant' && data.message?.content) {
+                const content = Array.isArray(data.message.content) ? data.message.content : [data.message.content];
+                for (const item of content) {
+                  if (item.type === 'text' && item.text) {
+                    lastTextContent = item.text;
+                  }
+                }
+              } else if (data.type === 'message' && data.content) {
+                if (typeof data.content === 'string') {
+                  lastTextContent = data.content;
+                } else if (Array.isArray(data.content)) {
+                  for (const item of data.content) {
+                    if (item.type === 'text' && item.text) {
+                      lastTextContent = item.text;
+                    }
+                  }
+                }
+              } else if (data.type === 'result' && data.result) {
+                lastTextContent = data.result;
+              }
+            }
+          } catch {
+            // Not JSON, continue
+          }
         }
 
         if (chunk.type === 'stderr') {
@@ -322,6 +358,39 @@ export const executeOpenCodeCommand = async params => {
           if (errorOutput) {
             await log(errorOutput, { stream: 'stderr' });
             allOutput += errorOutput;
+
+            // Issue #1263: Also try to parse stderr for text content
+            try {
+              const lines = errorOutput.split('\n');
+              for (const line of lines) {
+                if (!line.trim()) continue;
+                const data = JSON.parse(line);
+                if (data.type === 'text' && data.text) {
+                  lastTextContent = data.text;
+                } else if (data.type === 'assistant' && data.message?.content) {
+                  const content = Array.isArray(data.message.content) ? data.message.content : [data.message.content];
+                  for (const item of content) {
+                    if (item.type === 'text' && item.text) {
+                      lastTextContent = item.text;
+                    }
+                  }
+                } else if (data.type === 'message' && data.content) {
+                  if (typeof data.content === 'string') {
+                    lastTextContent = data.content;
+                  } else if (Array.isArray(data.content)) {
+                    for (const item of data.content) {
+                      if (item.type === 'text' && item.text) {
+                        lastTextContent = item.text;
+                      }
+                    }
+                  }
+                } else if (data.type === 'result' && data.result) {
+                  lastTextContent = data.result;
+                }
+              }
+            } catch {
+              // Not JSON, continue
+            }
           }
         } else if (chunk.type === 'exit') {
           exitCode = chunk.code;
@@ -374,6 +443,7 @@ export const executeOpenCodeCommand = async params => {
           limitReached: false,
           limitResetTime: null,
           permissionPromptDetected: true,
+          resultSummary: lastTextContent || null, // Issue #1263: Use last text content from JSON output stream
         };
       }
 
@@ -409,16 +479,23 @@ export const executeOpenCodeCommand = async params => {
           sessionId,
           limitReached,
           limitResetTime,
+          resultSummary: lastTextContent || null, // Issue #1263: Use last text content from JSON output stream
         };
       }
 
       await log('\n\n✅ OpenCode command completed');
 
+      // Issue #1263: Log if result summary was captured
+      if (lastTextContent) {
+        await log('📝 Captured result summary from OpenCode output', { verbose: true });
+      }
+
       return {
         success: true,
         sessionId,
         limitReached,
         limitResetTime,
+        resultSummary: lastTextContent || null, // Issue #1263: Use last text content from JSON output stream
       };
     } catch (error) {
       // Clean up the opencode.json config file even on error
@@ -441,6 +518,7 @@ export const executeOpenCodeCommand = async params => {
         sessionId: null,
         limitReached: false,
         limitResetTime: null,
+        resultSummary: null, // Issue #1263: No result summary available on error
       };
     }
   };

package/src/solve.config.lib.mjs

@@ -359,6 +359,16 @@ export const SOLVE_OPTION_DEFINITIONS = {
     description: 'Guide Claude to use agent-commander CLI (start-agent) instead of native Task tool for subagent delegation. Allows using any supported agent type (claude, opencode, codex, agent) with unified API. Only works with --tool claude and requires agent-commander to be installed.',
     default: false,
   },
+  'attach-solution-summary': {
+    type: 'boolean',
+    description: 'Attach the AI solution summary (from the result field) as a comment to the PR/issue after completion. The summary is extracted from the AI tool JSON output and posted under a "Solution summary" header.',
+    default: false,
+  },
+  'auto-attach-solution-summary': {
+    type: 'boolean',
+    description: 'Automatically attach solution summary only if the AI did not create any comments during the session. This provides visible feedback when the AI completes silently.',
+    default: false,
+  },
 };
 
 // Function to create yargs configuration - avoids duplication