@link-assistant/hive-mind 1.23.12 → 1.23.13

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @link-assistant/hive-mind
 
+## 1.23.13
+
+### Patch Changes
+
+- af1f456: fix: suppress dotenvx MISSING_ENV_FILE warnings in hive-telegram-bot --version
+  - Add early --version handling before loading dotenvx to avoid warnings
+  - Add ignore: ['MISSING_ENV_FILE'] option to make .env file optional
+  - Add tests for version output in tests/test-telegram-bot-version.mjs
+
 ## 1.23.12
 
 ### Patch Changes

package/README.md

@@ -149,11 +149,14 @@ Run the Hive Mind using Docker for safer local installation - no manual setup re
 # Pull the latest image from Docker Hub
 docker pull konard/hive-mind:latest
 
-# Run an interactive session
-docker run -it konard/hive-mind:latest
+# Start hive-mind container
+docker run -dit --name hive-mind konard/hive-mind:latest
 
-# IMPORTANT: Authenticate AFTER the Docker image is installed
-# This avoids build timeouts and allows the installation to complete successfully
+# Verify container started
+docker ps -a
+
+# Enter additional terminal process to do installation
+docker exec -it hive-mind /bin/bash
 
 # Inside the container, authenticate with GitHub
 gh-setup-git-identity
@@ -163,6 +166,15 @@ claude
 
 # 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
+docker attach hive-mind
+
+# Run bot here
+
+# Press Ctrl + P, Ctrl + Q to detach without destroying the container (no stopping of main bash process)
 ```
 
 **Benefits of Docker:**

package/package.json

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

package/src/telegram-bot.mjs

@@ -1,4 +1,10 @@
 #!/usr/bin/env node
+// Early exit for --version (issue #1318: avoid dotenvx MISSING_ENV_FILE warnings)
+if (process.argv.includes('--version')) {
+  const v = await import('./version.lib.mjs').then(m => m.getVersion()).catch(() => 'unknown');
+  console.log(v);
+  process.exit(v === 'unknown' ? 1 : 0);
+}
 
 import { spawn } from 'child_process';
 import { promisify } from 'util';
@@ -21,7 +27,9 @@ const dotenvx = dotenvxModule.default || dotenvxModule;
 const getenv = await use('getenv');
 
 // Load .env configuration as base
-dotenvx.config({ quiet: true });
+// quiet: true suppresses info messages, ignore: ['MISSING_ENV_FILE'] suppresses error when .env doesn't exist
+// This makes .env file optional (issue #1318)
+dotenvx.config({ quiet: true, ignore: ['MISSING_ENV_FILE'] });
 
 // Load .lenv configuration (if exists)
 // .lenv overrides .env
@@ -30,20 +38,15 @@ loadLenvConfig({ override: true, quiet: true });
 const yargsModule = await use('yargs@17.7.2');
 const yargs = yargsModule.default || yargsModule;
 const { hideBin } = await use('yargs@17.7.2/helpers');
-
-// Import solve and hive yargs configurations for validation
+// Import yargs configurations, GitHub utilities, and telegram helpers
 const { createYargsConfig: createSolveYargsConfig, detectMalformedFlags } = await import('./solve.config.lib.mjs');
 const { createYargsConfig: createHiveYargsConfig } = await import('./hive.config.lib.mjs');
-// Import GitHub URL parser for extracting URLs from messages
 const { parseGitHubUrl } = await import('./github.lib.mjs');
-// Import model validation for early validation with helpful error messages
 const { validateModelName } = await import('./model-validation.lib.mjs');
-// Import libraries for /limits, /version, and markdown escaping
 const { formatUsageMessage, getAllCachedLimits } = await import('./limits.lib.mjs');
 const { getVersionInfo, formatVersionMessage } = await import('./version-info.lib.mjs');
 const { escapeMarkdown, escapeMarkdownV2, cleanNonPrintableChars, makeSpecialCharsVisible } = await import('./telegram-markdown.lib.mjs');
 const { getSolveQueue, createQueueExecuteCallback } = await import('./telegram-solve-queue.lib.mjs');
-// Import extracted message filter functions for testability (issue #1207)
 const { isOldMessage: _isOldMessage, isGroupChat: _isGroupChat, isChatAuthorized: _isChatAuthorized, isForwardedOrReply: _isForwardedOrReply, extractCommandFromText } = await import('./telegram-message-filters.lib.mjs');
 // Import bot launcher with exponential backoff retry (issue #1240)
 const { launchBotWithRetry } = await import('./telegram-bot-launcher.lib.mjs');

package/src/version.lib.mjs

@@ -5,6 +5,11 @@ import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
 import { getGitVersion } from './git.lib.mjs';
 
+// Cache for version (immutable after first read)
+// This ensures the version remains consistent even if package.json changes during runtime
+// See issue #1318: version should be cached in RAM at startup
+let cachedVersion = null;
+
 async function isRunningAsScript() {
   const __filename = fileURLToPath(import.meta.url);
   const __dirname = dirname(__filename);
@@ -18,6 +23,11 @@ async function isRunningAsScript() {
 }
 
 export async function getVersion() {
+  // Return cached version if already computed (immutable after first read)
+  if (cachedVersion !== null) {
+    return cachedVersion;
+  }
+
   const __filename = fileURLToPath(import.meta.url);
   const __dirname = dirname(__filename);
   const packagePath = join(__dirname, '..', 'package.json');
@@ -28,13 +38,15 @@ export async function getVersion() {
     const currentVersion = packageJson.version;
 
     if (await isRunningAsScript()) {
-      const version = await getGitVersion(undefined, currentVersion);
-      return version;
+      cachedVersion = await getGitVersion(undefined, currentVersion);
+    } else {
+      cachedVersion = currentVersion;
     }
 
-    return currentVersion;
+    return cachedVersion;
   } catch {
-    return 'unknown';
+    cachedVersion = 'unknown';
+    return cachedVersion;
   }
 }