@link-assistant/hive-mind 1.17.0 → 1.17.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @link-assistant/hive-mind
 
+## 1.17.1
+
+### Patch Changes
+
+- 0e59647: Fix /solve-queue command: register /solve_queue handler, fix hint text to use underscore instead of hyphen (Telegram Bot API only supports underscores in command names)
+
 ## 1.17.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/hive-mind",
-  "version": "1.17.0",
+  "version": "1.17.1",
   "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",
+    "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: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/telegram-accept-invitations.lib.mjs

@@ -122,10 +122,10 @@ export function registerAcceptInvitesCommand(bot, options) {
   const { VERBOSE = false, isOldMessage, isForwardedOrReply, isGroupChat, isChatAuthorized, addBreadcrumb } = options;
 
   bot.command(/^accept[_-]?invites$/i, async ctx => {
-    VERBOSE && console.log('[VERBOSE] /accept-invites command received');
+    VERBOSE && console.log('[VERBOSE] /accept_invites command received');
     await addBreadcrumb({
       category: 'telegram.command',
-      message: '/accept-invites command received',
+      message: '/accept_invites command received',
       level: 'info',
       data: { chatId: ctx.chat?.id, chatType: ctx.chat?.type, userId: ctx.from?.id, username: ctx.from?.username },
     });
@@ -165,7 +165,7 @@ export function registerAcceptInvitesCommand(bot, options) {
       } catch (err) {
         // Ignore "message not modified" errors
         if (!err.message?.includes('message is not modified')) {
-          VERBOSE && console.log(`[VERBOSE] /accept-invites: Error updating message: ${err.message}`);
+          VERBOSE && console.log(`[VERBOSE] /accept_invites: Error updating message: ${err.message}`);
         }
       }
     };
@@ -228,7 +228,7 @@ export function registerAcceptInvitesCommand(bot, options) {
       state.isComplete = true;
       await updateMessage();
     } catch (error) {
-      console.error('Error in /accept-invites:', error);
+      console.error('Error in /accept_invites:', error);
       const escapedError = escapeMarkdown(error.message);
       await ctx.telegram.editMessageText(fetchingMessage.chat.id, fetchingMessage.message_id, undefined, `❌ Error fetching invitations: ${escapedError}\n\nMake sure \`gh\` CLI is installed and authenticated\\.`, { parse_mode: 'MarkdownV2' });
     }

package/src/telegram-bot.mjs

@@ -683,14 +683,15 @@ bot.command('help', async ctx => {
     message += '*/hive* - ❌ Disabled\n\n';
   }
 
+  message += '`/solve_queue` - Show solve queue status\n';
   message += '*/limits* - Show usage limits\n';
   message += '*/version* - Show bot and runtime versions\n';
-  message += '*/accept\\_invites* - Accept all pending GitHub invitations\n';
+  message += '`/accept_invites` - Accept all pending GitHub invitations\n';
   message += '*/merge* - Merge queue (experimental)\n';
   message += 'Usage: `/merge <github-repo-url>`\n';
   message += "Merges all PRs with 'ready' label sequentially.\n";
   message += '*/help* - Show this help message\n\n';
-  message += '⚠️ *Note:* /solve, /hive, /limits, /version, /accept\\_invites and /merge commands only work in group chats.\n\n';
+  message += '⚠️ *Note:* /solve, /hive, /solve\\_queue, /limits, /version, /accept\\_invites and /merge commands only work in group chats.\n\n';
   message += '🔧 *Common Options:*\n';
   message += '• `--model <model>` or `-m` - Specify AI model (sonnet, opus, haiku, haiku-3-5, haiku-3)\n';
   message += '• `--base-branch <branch>` or `-b` - Target branch for PR (default: repo default branch)\n';
@@ -839,6 +840,19 @@ registerMergeCommand(bot, {
   addBreadcrumb,
 });
 
+// Register /solve_queue command from separate module (issue #1232)
+const { registerSolveQueueCommand } = await import('./telegram-solve-queue-command.lib.mjs');
+const { handleSolveQueueCommand } = registerSolveQueueCommand(bot, {
+  VERBOSE,
+  isOldMessage,
+  isForwardedOrReply,
+  isGroupChat,
+  isChatAuthorized,
+  addBreadcrumb,
+  getSolveQueue,
+  getRunningClaudeProcesses,
+});
+
 // Named handler for /solve command - extracted for reuse by text-based fallback (issue #1207)
 async function handleSolveCommand(ctx) {
   if (VERBOSE) {
@@ -1023,7 +1037,7 @@ async function handleSolveCommand(ctx) {
   const existingItem = solveQueue.findByUrl(normalizedUrl);
   if (existingItem) {
     const statusText = existingItem.status === 'starting' || existingItem.status === 'started' ? 'being processed' : 'already in the queue';
-    await ctx.reply(`❌ This URL is ${statusText}.\n\nURL: ${escapeMarkdown(normalizedUrl)}\nStatus: ${existingItem.status}\n\n💡 Use /solve-queue to check the queue status.`, { parse_mode: 'Markdown', reply_to_message_id: ctx.message.message_id });
+    await ctx.reply(`❌ This URL is ${statusText}.\n\nURL: ${escapeMarkdown(normalizedUrl)}\nStatus: ${existingItem.status}\n\n💡 Use /solve_queue to check the queue status.`, { parse_mode: 'Markdown', reply_to_message_id: ctx.message.message_id });
     return;
   }
 
@@ -1261,6 +1275,8 @@ bot.on('message', async (ctx, next) => {
   const handlers = {
     solve: handleSolveCommand,
     hive: handleHiveCommand,
+    solve_queue: handleSolveQueueCommand,
+    solvequeue: handleSolveQueueCommand,
   };
 
   const handler = handlers[extracted.command];

package/src/telegram-solve-queue-command.lib.mjs

@@ -0,0 +1,96 @@
+/**
+ * Telegram /solve_queue command implementation
+ *
+ * This module provides the /solve_queue command functionality for the Telegram bot,
+ * allowing users to view the current solve queue status.
+ *
+ * Features:
+ * - Shows pending, processing, completed, and failed queue items
+ * - Per-tool queue breakdown (claude, opencode, etc.)
+ * - Lists currently processing and waiting items
+ * - Running Claude process count
+ *
+ * @see https://github.com/link-assistant/hive-mind/issues/1232
+ */
+
+/**
+ * Registers the /solve_queue command handler with the bot
+ * @param {Object} bot - The Telegraf bot instance
+ * @param {Object} options - Options object
+ * @param {boolean} options.VERBOSE - Whether to enable verbose logging
+ * @param {Function} options.isOldMessage - Function to check if message is old
+ * @param {Function} options.isForwardedOrReply - Function to check if message is forwarded/reply
+ * @param {Function} options.isGroupChat - Function to check if chat is a group
+ * @param {Function} options.isChatAuthorized - Function to check if chat is authorized
+ * @param {Function} options.addBreadcrumb - Function to add breadcrumbs for monitoring
+ * @param {Function} options.getSolveQueue - Function to get the solve queue instance
+ * @param {Function} options.getRunningClaudeProcesses - Function to get running claude processes
+ * @returns {{ handleSolveQueueCommand: Function }} The command handler for use in text fallback
+ */
+export function registerSolveQueueCommand(bot, options) {
+  const { VERBOSE = false, isOldMessage, isForwardedOrReply, isGroupChat, isChatAuthorized, addBreadcrumb, getSolveQueue, getRunningClaudeProcesses } = options;
+
+  async function handleSolveQueueCommand(ctx) {
+    VERBOSE && console.log('[VERBOSE] /solve_queue command received');
+
+    await addBreadcrumb({
+      category: 'telegram.command',
+      message: '/solve_queue command received',
+      level: 'info',
+      data: { chatId: ctx.chat?.id, chatType: ctx.chat?.type, userId: ctx.from?.id, username: ctx.from?.username },
+    });
+
+    // Ignore messages sent before bot started
+    if (isOldMessage(ctx)) {
+      VERBOSE && console.log('[VERBOSE] /solve_queue ignored: old message');
+      return;
+    }
+
+    // Ignore forwarded or reply messages
+    if (isForwardedOrReply(ctx)) {
+      VERBOSE && console.log('[VERBOSE] /solve_queue ignored: forwarded or reply');
+      return;
+    }
+
+    if (!isGroupChat(ctx)) {
+      VERBOSE && console.log('[VERBOSE] /solve_queue ignored: not a group chat');
+      await ctx.reply('❌ The /solve_queue command only works in group chats. Please add this bot to a group and make it an admin.', {
+        reply_to_message_id: ctx.message.message_id,
+      });
+      return;
+    }
+
+    const chatId = ctx.chat.id;
+    if (!isChatAuthorized(chatId)) {
+      VERBOSE && console.log('[VERBOSE] /solve_queue ignored: chat not authorized');
+      await ctx.reply(`❌ This chat (ID: ${chatId}) is not authorized to use this bot. Please contact the bot administrator.`, {
+        reply_to_message_id: ctx.message.message_id,
+      });
+      return;
+    }
+
+    VERBOSE && console.log('[VERBOSE] /solve_queue passed all checks, generating status...');
+
+    const solveQueue = getSolveQueue({ verbose: VERBOSE });
+    const claudeProcs = await getRunningClaudeProcesses(VERBOSE);
+
+    // Use the queue's built-in detailed status formatter
+    let message = solveQueue.formatDetailedStatus();
+
+    // Add running Claude processes info
+    message += `\n🖥️ Running Claude processes: ${claudeProcs.count}`;
+
+    await ctx.reply(message, {
+      parse_mode: 'Markdown',
+      reply_to_message_id: ctx.message.message_id,
+    });
+  }
+
+  // Match /solve_queue, /solve-queue, or /solvequeue (case-insensitive)
+  // Note: Telegram Bot API only supports underscores in command names, not hyphens.
+  // The entity-based matching handles /solve_queue and /solvequeue.
+  // /solve-queue is handled by the text-based fallback in telegram-bot.mjs (issue #1232).
+  bot.command(/^solve[_-]?queue$/i, handleSolveQueueCommand);
+
+  return { handleSolveQueueCommand };
+}

package/src/telegram-solve-queue.lib.mjs

@@ -37,11 +37,12 @@ export const QUEUE_CONFIG = {
   RAM_THRESHOLD: 0.65, // Enqueue if RAM usage >= 65%
   // CPU threshold uses 5-minute load average, not instantaneous CPU usage
   CPU_THRESHOLD: 0.65, // Enqueue if 5-minute load average >= 65% of CPU count
-  DISK_THRESHOLD: 0.9, // One-at-a-time if disk usage >= 90%
+  DISK_THRESHOLD: 0.9, // One-at-a-time if disk usage >= 90%, tuned for VM with 100 GB drive
 
   // API limit thresholds (usage ratios: 0.0 - 1.0)
   // All thresholds use >= comparison (inclusive)
-  CLAUDE_5_HOUR_SESSION_THRESHOLD: 0.75, // One-at-a-time if 5-hour limit >= 75%
+  // Fine-tuned for Claude MAX $200 subscription
+  CLAUDE_5_HOUR_SESSION_THRESHOLD: 0.65, // One-at-a-time if 5-hour limit >= 65%
   CLAUDE_WEEKLY_THRESHOLD: 0.97, // One-at-a-time if weekly limit >= 97%
   GITHUB_API_THRESHOLD: 0.75, // Enqueue if GitHub >= 75% with parallel claude
 
@@ -92,9 +93,9 @@ export async function getRunningClaudeProcesses(verbose = false) {
       .filter(p => p.pid);
 
     if (verbose) {
-      console.log(`[VERBOSE] /solve-queue found ${processes.length} running claude processes`);
+      console.log(`[VERBOSE] /solve_queue found ${processes.length} running claude processes`);
       if (processes.length > 0) {
-        console.log(`[VERBOSE] /solve-queue processes: ${JSON.stringify(processes)}`);
+        console.log(`[VERBOSE] /solve_queue processes: ${JSON.stringify(processes)}`);
       }
     }
 
@@ -104,7 +105,7 @@ export async function getRunningClaudeProcesses(verbose = false) {
     };
   } catch (error) {
     if (verbose) {
-      console.error('[VERBOSE] /solve-queue error counting claude processes:', error.message);
+      console.error('[VERBOSE] /solve_queue error counting claude processes:', error.message);
     }
     return { count: 0, processes: [] };
   }
@@ -333,7 +334,7 @@ export class SolveQueue {
    */
   log(message) {
     if (this.verbose) {
-      console.log(`[VERBOSE] /solve-queue: ${message}`);
+      console.log(`[VERBOSE] /solve_queue: ${message}`);
     }
   }
 
@@ -837,7 +838,7 @@ export class SolveQueue {
 
     this.consumerTask = this.runConsumer();
     this.consumerTask.catch(error => {
-      console.error('[solve-queue] Consumer error:', error);
+      console.error('[solve_queue] Consumer error:', error);
       this.consumerTask = null;
     });
   }
@@ -933,7 +934,7 @@ export class SolveQueue {
 
         // Execute in background
         this.executeItem(item).catch(error => {
-          console.error(`[solve-queue] Execution error for ${item.id}:`, error);
+          console.error(`[solve_queue] Execution error for ${item.id}:`, error);
         });
       }
     }
@@ -1011,7 +1012,7 @@ export class SolveQueue {
             } catch (error) {
               // Log message edit failures for debugging
               // See: https://github.com/link-assistant/hive-mind/issues/1062
-              console.error(`[solve-queue] Failed to update message for item ${item.id}: ${error.message}`);
+              console.error(`[solve_queue] Failed to update message for item ${item.id}: ${error.message}`);
             }
           }
         }
@@ -1022,7 +1023,7 @@ export class SolveQueue {
     } catch (error) {
       item.setFailed(error);
       this.stats.totalFailed++;
-      console.error(`[solve-queue] Item failed: ${item.id}`, error);
+      console.error(`[solve_queue] Item failed: ${item.id}`, error);
 
       // Try to update message with error
       const { chatId, messageId } = item.messageInfo || {};
@@ -1032,7 +1033,7 @@ export class SolveQueue {
         } catch (editError) {
           // Log the edit failure for debugging
           // See: https://github.com/link-assistant/hive-mind/issues/1062
-          console.error(`[solve-queue] Failed to update error message for item ${item.id}: ${editError.message}`);
+          console.error(`[solve_queue] Failed to update error message for item ${item.id}: ${editError.message}`);
         }
       }
     } finally {