@link-assistant/hive-mind 1.5.0 → 1.6.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @link-assistant/hive-mind
 
+## 1.6.1
+
+### Patch Changes
+
+- b07fa91: Improve /limits output format for better clarity and consistency: use 5m load average for CPU calculation (matching /solve queue), show CPU cores as "X.XX/Y CPU cores used" format consistent with RAM and Disk display
+
+## 1.6.0
+
+### Minor Changes
+
+- 56d95bd: Add `--prompt-subagents-via-agent-commander` option to guide Claude to use agent-commander CLI for subagent delegation instead of native Task tool. This allows using any supported agent type (claude, opencode, codex, agent) with a unified API and saves main agent context. The prompt guidance is only included when agent-commander (start-agent) is actually installed on the system.
+
 ## 1.5.0
 
 ### Minor Changes

package/package.json

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

package/src/claude.lib.mjs

@@ -25,21 +25,13 @@ const showResumeCommand = async (sessionId, tempDir, claudePath, model, log) =>
   await log(`   ${cmd}\n`);
 };
 
-/**
- * Format numbers with spaces as thousands separator (no commas)
- * Per issue #667: Use spaces for thousands, . for decimals
- * @param {number|null|undefined} num - Number to format
- * @returns {string} Formatted number string
- */
+/** Format numbers with spaces as thousands separator (no commas) */
 export const formatNumber = num => {
   if (num === null || num === undefined) return 'N/A';
-  // Convert to string and split on decimal point
   const parts = num.toString().split('.');
   const integerPart = parts[0];
   const decimalPart = parts[1];
-  // Add spaces every 3 digits from the right
   const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, ' ');
-  // Return with decimal part if it exists
   return decimalPart !== undefined ? `${formattedInteger}.${decimalPart}` : formattedInteger;
 };
 // Available model configurations
@@ -414,6 +406,18 @@ export const checkPlaywrightMcpAvailability = async () => {
  */
 export const executeClaude = async params => {
   const { issueUrl, issueNumber, prNumber, prUrl, branchName, tempDir, workspaceTmpDir, isContinueMode, mergeStateStatus, forkedRepo, feedbackLines, forkActionsUrl, owner, repo, argv, log, setLogFile, getLogFile, formatAligned, getResourceSnapshot, claudePath, $ } = params;
+
+  // Check if agent-commander is installed when the option is enabled
+  if (argv.promptSubagentsViaAgentCommander) {
+    try {
+      await $`which start-agent`;
+      argv.agentCommanderInstalled = true;
+    } catch {
+      argv.agentCommanderInstalled = false;
+      await log('⚠️  agent-commander not installed; prompt guidance will be skipped (npm i -g @link-assistant/agent-commander)');
+    }
+  }
+
   // Import prompt building functions from claude.prompts.lib.mjs
   const { buildUserPrompt, buildSystemPrompt } = await import('./claude.prompts.lib.mjs');
   // Build the user prompt

package/src/claude.prompts.lib.mjs

@@ -282,6 +282,31 @@ Plan sub-agent usage.
    - When using the Plan sub-agent, you can add it as the first item in your todo list.
    - When you delegate planning, use the Task tool with subagent_type="Plan" before starting implementation work.`
        : ''
+   }${
+     argv && argv.promptSubagentsViaAgentCommander && argv.agentCommanderInstalled
+       ? `
+
+Agent Commander usage (unified subagent delegation).
+   - When you need to delegate tasks to subagents, use the agent-commander CLI tool (start-agent) instead of the native Task tool.
+   - Agent Commander provides a unified API for different agent types (claude, opencode, codex, agent) and supports various isolation modes.
+   - To delegate a task, use the Bash tool to run start-agent with appropriate parameters:
+      \`\`\`bash
+      start-agent --tool claude --working-directory "$(pwd)" --prompt "Your task description here"
+      \`\`\`
+   - Common start-agent parameters:
+      --tool <name>: Agent to use (claude, opencode, codex, agent)
+      --working-directory <path>: Execution directory (use current directory for context)
+      --prompt <text>: The task to delegate
+      --model <name>: Model to use (sonnet, opus, haiku, grok, etc.)
+      --isolation <mode>: Execution context (none, screen, docker)
+      --detached: Run in background mode
+   - Examples:
+      Explore codebase: start-agent --tool claude --working-directory "$(pwd)" --prompt "Explore the codebase structure and find how authentication is implemented"
+      Run with specific model: start-agent --tool claude --working-directory "$(pwd)" --model opus --prompt "Review this complex algorithm"
+      Use different agent: start-agent --tool opencode --working-directory "$(pwd)" --model grok --prompt "Analyze performance issues"
+   - Benefits: Saves main agent context, supports any agent type, provides unified API across different AI tools.
+   - Note: The subagent will have access to the same working directory and can read/write files as needed.`
+       : ''
    }${ciExamples}${getArchitectureCareSubPrompt(argv)}`;
 };
 

package/src/limits.lib.mjs

@@ -139,6 +139,25 @@ function formatBytes(bytes) {
   return `${value.toFixed(decimals)} ${sizes[i]}`;
 }
 
+/**
+ * Format two byte values into a combined "used/total UNIT used" format
+ * @param {number} usedBytes - Used size in bytes
+ * @param {number} totalBytes - Total size in bytes
+ * @returns {string} Formatted string (e.g., "2.8/11.7 GB used")
+ */
+function formatBytesRange(usedBytes, totalBytes) {
+  if (totalBytes === 0) return '0/0 B used';
+  const k = 1024;
+  const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+  // Determine unit based on total (larger value)
+  const i = Math.floor(Math.log(totalBytes) / Math.log(k));
+  const usedValue = usedBytes / Math.pow(k, i);
+  const totalValue = totalBytes / Math.pow(k, i);
+  // Use 1 decimal place for GB and above, none for smaller units
+  const decimals = i >= 3 ? 1 : 0;
+  return `${usedValue.toFixed(decimals)}/${totalValue.toFixed(decimals)} ${sizes[i]} used`;
+}
+
 /**
  * Get GitHub API rate limits by calling gh api rate_limit
  * Returns rate limit info for core, search, graphql, and other resources
@@ -266,9 +285,10 @@ export async function getCpuLoadInfo(verbose = false) {
       };
     }
 
-    // Calculate usage percentage based on load average vs CPU count
+    // Calculate usage percentage based on 5-minute load average vs CPU count
     // Load average of 1.0 per CPU = 100% utilization
-    const usagePercentage = Math.min(100, Math.round((loadAvg1 / cpuCount) * 100));
+    // Using 5m average for consistency with solve queue (see issue #1137)
+    const usagePercentage = Math.min(100, Math.round((loadAvg5 / cpuCount) * 100));
 
     if (verbose) {
       console.log(`[VERBOSE] /limits CPU load: ${loadAvg1.toFixed(2)} (1m), ${loadAvg5.toFixed(2)} (5m), ${loadAvg15.toFixed(2)} (15m), ${cpuCount} CPUs, ${usagePercentage}% used`);
@@ -663,8 +683,9 @@ export function formatUsageMessage(usage, diskSpace = null, githubRateLimit = nu
     message += 'CPU\n';
     const usedBar = getProgressBar(cpuLoad.usagePercentage);
     message += `${usedBar} ${cpuLoad.usagePercentage}% used\n`;
-    message += `Load avg: ${cpuLoad.loadAvg1.toFixed(2)} (1m) ${cpuLoad.loadAvg5.toFixed(2)} (5m) ${cpuLoad.loadAvg15.toFixed(2)} (15m)\n`;
-    message += `${cpuLoad.cpuCount} CPU core${cpuLoad.cpuCount > 1 ? 's' : ''}\n\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`;
   }
 
   // Memory section (if provided)
@@ -672,7 +693,7 @@ export function formatUsageMessage(usage, diskSpace = null, githubRateLimit = nu
     message += 'RAM\n';
     const usedBar = getProgressBar(memory.usedPercentage);
     message += `${usedBar} ${memory.usedPercentage}% used\n`;
-    message += `${memory.usedFormatted} used of ${memory.totalFormatted}\n\n`;
+    message += `${formatBytesRange(memory.usedBytes, memory.totalBytes)}\n\n`;
   }
 
   // Disk space section (if provided)
@@ -681,7 +702,7 @@ export function formatUsageMessage(usage, diskSpace = null, githubRateLimit = nu
     // Show used percentage with progress bar
     const usedBar = getProgressBar(diskSpace.usedPercentage);
     message += `${usedBar} ${diskSpace.usedPercentage}% used\n`;
-    message += `${diskSpace.usedFormatted} used of ${diskSpace.totalFormatted}\n\n`;
+    message += `${formatBytesRange(diskSpace.usedBytes, diskSpace.totalBytes)}\n\n`;
   }
 
   // GitHub API rate limits section (if provided)

package/src/solve.config.lib.mjs

@@ -326,6 +326,11 @@ export const createYargsConfig = yargsInstance => {
         description: 'Automatically repair git configuration using gh-setup-git-identity --repair when git identity is not configured. Requires gh-setup-git-identity to be installed.',
         default: false,
       })
+      .option('prompt-subagents-via-agent-commander', {
+        type: 'boolean',
+        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,
+      })
       .parserConfiguration({
         'boolean-negation': true,
       })