@link-assistant/hive-mind 1.25.1 → 1.25.3

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @link-assistant/hive-mind
 
+## 1.25.3
+
+### Patch Changes
+
+- 0ed3ccb: fix: prevent --auto-restart-until-mergeable infinite loop when no CI/CD is configured (Issue #1345)
+
+  Previously, when a repository had no GitHub Actions workflows configured, `--auto-restart-until-mergeable` would loop indefinitely because `getDetailedCIStatus()` returned `{ status: 'no_checks' }` and the code always treated this as a transient race condition (checks haven't started yet).
+
+  Now the fix correctly handles the `no_checks` case by also checking `checkPRMergeable()`. If GitHub reports the PR as `MERGEABLE` (`mergeStateStatus: CLEAN`), the repository has no required CI checks and the process exits immediately with an appropriate message ("No CI/CD checks are configured for this repository — PR is mergeable"). If the PR is not yet mergeable, the existing wait behavior is preserved.
+
+  Full case study analysis including timeline reconstruction from logs in `docs/case-studies/issue-1345/`.
+
+## 1.25.2
+
+### Patch Changes
+
+- 0453550: feat: show all limits even when Claude authentication is expired (Issue #1343)
+
+  Previously, when Claude authentication expired, the `/limits` command would fail completely and show no information at all.
+
+  Now the command gracefully handles Claude auth failures:
+  - The error message (e.g., "Claude authentication expired. Please use /solve or /hive commands to trigger re-authentication of Claude.") is shown inline in the Claude limits sections
+  - All other limits sections (CPU, RAM, Disk space, GitHub API) continue to display normally
+
 ## 1.25.1
 
 ### Patch Changes

package/README.md

@@ -164,12 +164,29 @@ gh-setup-git-identity
 # Authenticate with Claude
 claude
 
+# Optionally set configuration like this:
+# Use /config command and set:
+# Reduce motion                             true # Will save your ssh trafic, and make Claude Code more responsive (less latency)
+# Thinking mode                             false # Anthropic models perform better and cheaper without thinking
+# Model                                     haiku # chepear for connection testing manually
+# Claude in Chrome enabled by default       false # No need for Chrome support on server
+
+# Optionally test Claude connection
+claude -p hi --model haiku
+
+# You might need to update hive-mind and agent to latest versions:
+bun install -g @link-assistant/hive-mind
+bun install -g @link-assistant/agent
+
 # Now you can use hive and solve commands
 solve https://github.com/owner/repo/issues/123
 
 # Or you can run telegram bot:
 
-# Run an to main process
+# Exit from additional bash session
+exit
+
+# Attach to main bash process
 docker attach hive-mind
 
 # Run bot here
@@ -187,6 +204,44 @@ docker attach hive-mind
 
 See [docs/DOCKER.md](./docs/DOCKER.md) for advanced Docker usage.
 
+#### Stoping and removing docker container
+
+```
+# Attach to main docker process to stop the container
+docker attach hive-mind
+
+^C # stop the telegram bot
+
+exit # exit/stop the container
+
+docker ps -a # show list of docker containers
+# CONTAINER ID   IMAGE                     COMMAND       CREATED      STATUS                        PORTS     NAMES
+# fd0fd4470ec3   konard/hive-mind:latest   "/bin/bash"   5 days ago   Exited (130) 16 seconds ago             hive-mind
+
+
+df -h # check disk space
+# Filesystem      Size  Used Avail Use% Mounted on
+# tmpfs           1.2G  1.1M  1.2G   1% /run
+# /dev/sda1        96G   87G  9.8G  90% /
+# tmpfs           5.9G     0  5.9G   0% /dev/shm
+# tmpfs           5.0M     0  5.0M   0% /run/lock
+# /dev/sda16      881M  117M  703M  15% /boot
+# /dev/sda15      105M  6.2M   99M   6% /boot/efi
+# tmpfs           1.2G   12K  1.2G   1% /run/user/0
+
+docker rm hive-mind # remove docker container frees space used by the container, does not delete image
+
+df -h # check disk space (to confirm space is freed)
+# Filesystem      Size  Used Avail Use% Mounted on
+# tmpfs           1.2G  1.1M  1.2G   1% /run
+# /dev/sda1        96G   26G   71G  27% /
+# tmpfs           5.9G     0  5.9G   0% /dev/shm
+# tmpfs           5.0M     0  5.0M   0% /run/lock
+# /dev/sda16      881M  117M  703M  15% /boot
+# /dev/sda15      105M  6.2M   99M   6% /boot/efi
+# tmpfs           1.2G   12K  1.2G   1% /run/user/0
+```
+
 ### Helm Installation (Kubernetes)
 
 Deploy Hive Mind on Kubernetes using Helm:

package/package.json

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

package/src/limits.lib.mjs

@@ -694,15 +694,16 @@ export function calculateTimePassedPercentage(resetsAt, periodHours) {
  * Format Claude usage data into a Telegram-friendly message
  * Shows threshold markers in progress bars to indicate where queue behavior changes.
  *
- * @param {Object} usage - The usage object from getClaudeUsageLimits
+ * @param {Object|null} usage - The usage object from getClaudeUsageLimits, or null if unavailable
  * @param {Object} diskSpace - Optional disk space info from getDiskSpaceInfo
  * @param {Object} githubRateLimit - Optional GitHub rate limit info from getGitHubRateLimits
  * @param {Object} cpuLoad - Optional CPU load info from getCpuLoadInfo
  * @param {Object} memory - Optional memory info from getMemoryInfo
+ * @param {string|null} claudeError - Optional error message to show in Claude sections (e.g., auth expired)
  * @returns {string} Formatted message
  * @see https://github.com/link-assistant/hive-mind/issues/1242
  */
-export function formatUsageMessage(usage, diskSpace = null, githubRateLimit = null, cpuLoad = null, memory = null) {
+export function formatUsageMessage(usage, diskSpace = null, githubRateLimit = null, cpuLoad = null, memory = null, claudeError = null) {
   // Use code block for monospace font to align progress bars properly
   let message = '```\n';
 
@@ -761,10 +762,18 @@ export function formatUsageMessage(usage, diskSpace = null, githubRateLimit = nu
     message += '\n';
   }
 
+  // Claude limits section
+  // When there's an error (e.g., auth expired), show it once here instead of repeating in each subsection
+  if (claudeError) {
+    message += `Claude limits\n${claudeError}\n\n`;
+  }
+
   // Claude 5 hour session (five_hour)
   // Threshold: One-at-a-time mode when usage >= 65%
   message += 'Claude 5 hour session\n';
-  if (usage.currentSession.percentage !== null) {
+  if (claudeError) {
+    // Error already shown above; skip subsection content
+  } else if (usage && usage.currentSession.percentage !== null) {
     // Add time passed progress bar first (no threshold marker for time)
     const timePassed = calculateTimePassedPercentage(usage.currentSession.resetsAt, 5);
     if (timePassed !== null) {
@@ -796,7 +805,9 @@ export function formatUsageMessage(usage, diskSpace = null, githubRateLimit = nu
   // Current week (all models / seven_day)
   // Threshold: One-at-a-time mode when usage >= 97%
   message += 'Current week (all models)\n';
-  if (usage.allModels.percentage !== null) {
+  if (claudeError) {
+    // Error already shown above; skip subsection content
+  } else if (usage && usage.allModels.percentage !== null) {
     // Add time passed progress bar first (no threshold marker for time)
     const timePassed = calculateTimePassedPercentage(usage.allModels.resetsAt, 168);
     if (timePassed !== null) {
@@ -828,7 +839,9 @@ export function formatUsageMessage(usage, diskSpace = null, githubRateLimit = nu
   // Current week (Sonnet only / seven_day_sonnet)
   // Threshold: One-at-a-time mode when usage >= 97% (same as all models)
   message += 'Current week (Sonnet only)\n';
-  if (usage.sonnetOnly.percentage !== null) {
+  if (claudeError) {
+    // Error already shown above; skip subsection content
+  } else if (usage && usage.sonnetOnly.percentage !== null) {
     // Add time passed progress bar first (no threshold marker for time)
     const timePassed = calculateTimePassedPercentage(usage.sonnetOnly.resetsAt, 168);
     if (timePassed !== null) {

package/src/solve.auto-merge.lib.mjs

@@ -187,12 +187,32 @@ const getMergeBlockers = async (owner, repo, prNumber, verbose = false) => {
   const ciStatus = await getDetailedCIStatus(owner, repo, prNumber, verbose);
 
   if (ciStatus.status === 'no_checks') {
-    // No CI checks exist yet - race condition after push, treat as pending
-    blockers.push({
-      type: 'ci_pending',
-      message: 'CI/CD checks have not started yet (waiting for checks to appear)',
-      details: [],
-    });
+    // No CI checks exist yet - this could be:
+    // 1. A race condition after push (checks haven't started yet) - wait
+    // 2. A repository with no CI/CD configured at all - should be mergeable immediately
+    //
+    // Issue #1345: Distinguish by checking the PR's mergeability status.
+    // If GitHub says the PR is MERGEABLE (mergeStateStatus === 'CLEAN'),
+    // then no CI is required and we should not block indefinitely.
+    // Otherwise (e.g. mergeStateStatus === 'BLOCKED'), treat as pending race condition.
+    const earlyMergeStatus = await checkPRMergeable(owner, repo, prNumber, verbose);
+    if (earlyMergeStatus.mergeable) {
+      // PR is already mergeable with no CI checks - the repo has no CI/CD configured.
+      // Do NOT add a ci_pending blocker. The mergeability check below will also
+      // confirm this is mergeable, so blockers will be empty → PR IS MERGEABLE path.
+      if (verbose) {
+        console.log(`[VERBOSE] /merge: PR #${prNumber} has no CI checks and is already MERGEABLE - no CI/CD configured`);
+      }
+      // Return early with no CI blocker, mergeability already confirmed
+      return { blockers, ciStatus, noCiConfigured: true };
+    } else {
+      // PR is not yet mergeable despite no checks - treat as pending race condition
+      blockers.push({
+        type: 'ci_pending',
+        message: 'CI/CD checks have not started yet (waiting for checks to appear)',
+        details: [],
+      });
+    }
   } else if (ciStatus.status === 'pending') {
     // CI is still running or queued - wait for completion
     const pendingNames = [...ciStatus.pendingChecks, ...ciStatus.queuedChecks].map(c => c.name);
@@ -272,7 +292,7 @@ const getMergeBlockers = async (owner, repo, prNumber, verbose = false) => {
     });
   }
 
-  return blockers;
+  return { blockers, ciStatus, noCiConfigured: false };
 };
 
 /**
@@ -341,7 +361,7 @@ export const watchUntilMergeable = async params => {
 
     try {
       // Get merge blockers
-      const blockers = await getMergeBlockers(owner, repo, prNumber, argv.verbose);
+      const { blockers, noCiConfigured } = await getMergeBlockers(owner, repo, prNumber, argv.verbose);
 
       // Check for new comments from non-bot users
       const { hasNewComments, comments } = await checkForNonBotComments(owner, repo, prNumber, issueNumber, lastCheckTime, argv.verbose);
@@ -364,7 +384,9 @@ export const watchUntilMergeable = async params => {
 
             // Post success comment
             try {
-              const commentBody = `## 🎉 Auto-merged\n\nThis pull request has been automatically merged by hive-mind after all CI checks passed and the PR became mergeable.\n\n---\n*Auto-merged by hive-mind with --auto-merge flag*`;
+              // Issue #1345: Differentiate message when no CI is configured
+              const ciLine = noCiConfigured ? '- No CI/CD checks are configured for this repository' : '- All CI checks have passed';
+              const commentBody = `## 🎉 Auto-merged\n\nThis pull request has been automatically merged by hive-mind.\n${ciLine}\n\n---\n*Auto-merged by hive-mind with --auto-merge flag*`;
               await $`gh pr comment ${prNumber} --repo ${owner}/${repo} --body ${commentBody}`;
             } catch {
               // Don't fail if comment posting fails
@@ -386,7 +408,9 @@ export const watchUntilMergeable = async params => {
             const readyToMergeSignature = '## ✅ Ready to merge';
             const hasExistingComment = await checkForExistingComment(owner, repo, prNumber, readyToMergeSignature, argv.verbose);
             if (!hasExistingComment) {
-              const commentBody = `## ✅ Ready to merge\n\nThis pull request is now ready to be merged:\n- All CI checks have passed\n- No merge conflicts\n- No pending changes\n\n---\n*Monitored by hive-mind with --auto-restart-until-mergeable flag*`;
+              // Issue #1345: Differentiate message when no CI is configured
+              const ciLine = noCiConfigured ? '- No CI/CD checks are configured for this repository' : '- All CI checks have passed';
+              const commentBody = `## ✅ Ready to merge\n\nThis pull request is now ready to be merged:\n${ciLine}\n- No merge conflicts\n- No pending changes\n\n---\n*Monitored by hive-mind with --auto-restart-until-mergeable flag*`;
               await $`gh pr comment ${prNumber} --repo ${owner}/${repo} --body ${commentBody}`;
             } else {
               await log(formatAligned('', 'Skipping duplicate "Ready to merge" comment', '', 2));

package/src/telegram-bot.mjs

@@ -780,14 +780,12 @@ bot.command('limits', async ctx => {
   // Get all limits using shared cache (3min for API, 2min for system)
   const limits = await getAllCachedLimits(VERBOSE);
 
-  if (!limits.claude.success) {
-    const escapedError = escapeMarkdownV2(limits.claude.error, { preserveCodeBlocks: true });
-    await ctx.telegram.editMessageText(fetchingMessage.chat.id, fetchingMessage.message_id, undefined, `❌ ${escapedError}`, { parse_mode: 'MarkdownV2' });
-    return;
-  }
-
   // Format the message with usage limits and queue status
-  let message = '📊 *Usage Limits*\n\n' + formatUsageMessage(limits.claude.usage, limits.disk.success ? limits.disk.diskSpace : null, limits.github.success ? limits.github.githubRateLimit : null, limits.cpu.success ? limits.cpu.cpuLoad : null, limits.memory.success ? limits.memory.memory : null);
+  // If Claude auth failed, pass the error to formatUsageMessage to show it in the Claude sections
+  // while still displaying all other limits sections (disk, GitHub, CPU, memory)
+  // See: https://github.com/link-assistant/hive-mind/issues/1343
+  const claudeError = limits.claude.success ? null : limits.claude.error;
+  let message = '📊 *Usage Limits*\n\n' + formatUsageMessage(limits.claude.success ? limits.claude.usage : null, limits.disk.success ? limits.disk.diskSpace : null, limits.github.success ? limits.github.githubRateLimit : null, limits.cpu.success ? limits.cpu.cpuLoad : null, limits.memory.success ? limits.memory.memory : null, claudeError);
   const solveQueue = getSolveQueue({ verbose: VERBOSE });
   // Insert per-queue status into the code block
   // Shows each queue (claude, agent) with pending/processing counts