@link-assistant/hive-mind 1.78.0 → 1.78.2

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @link-assistant/hive-mind
 
+## 1.78.2
+
+### Patch Changes
+
+- 70db26f: Ensure Telegram work-session completion messages recover pull request links from completed solve logs when linked-issue lookup does not return a PR.
+
+## 1.78.1
+
+### Patch Changes
+
+- dc8bb99: Group interactive `system.thinking_tokens` events into one editable PR comment and handle observed system lifecycle events without unrecognized-event noise.
+- d704dfc: fix(install): redirect npm global prefix when root-owned to avoid EACCES at startup (#1897)
+
+  `use-m` loads runtime dependencies (command-stream, getenv, yargs, …) by shelling
+  out to `npm install -g <alias>@npm:<pkg>@latest`, which installs into the global
+  prefix reported by `npm root -g`. When the CLI was launched under a system-wide
+  Node.js whose global `node_modules` is owned by root (e.g.
+  `/opt/node-v24.16.0-linux-x64/lib/node_modules`), that install failed with
+  `npm error code EACCES … rename … command-stream-v-latest` and the whole process
+  crashed at the very first `use()` call (`Error: Failed to install
+command-stream@latest globally.`). This commonly happens when hive-mind was
+  installed with `bun add -g` (user-owned `~/.bun/...`) but invoked under a system
+  Node whose global prefix needs root.
+
+  The new `src/npm-global-prefix.lib.mjs` preflight mirrors npm's own documented
+  EACCES remedy: before any real `use-m` bootstrap runs, it detects a non-writable
+  npm global prefix and redirects `npm_config_prefix` (honoured by both
+  `npm install -g` and `npm root -g`) to a user-writable `~/.npm-global`,
+  prepending its `bin` to `PATH`. The common case where the prefix is already
+  writable stays a no-op with no extra `npm` spawn.
+
+  Hive Mind now routes direct repository `use-m` bootstraps through
+  `src/use-m-bootstrap.lib.mjs`, including CLI entry points, shared source modules,
+  scripts, and executable tests. The workaround skips Windows' different global
+  layout, skips Bun/Deno runtimes, and respects explicitly preset
+  `npm_config_prefix` or `NPM_CONFIG_PREFIX` values.
+
 ## 1.78.0
 
 ### Minor Changes

package/package.json

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

package/src/agent.lib.mjs

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
+import { ensureUseM } from './use-m-bootstrap.lib.mjs';
 // Agent-related utility functions
 
 // Check if use is already defined (when imported from solve.mjs)
 // If not, fetch it (when running standalone)
 if (typeof globalThis.use === 'undefined') {
-  globalThis.use = (await eval(await (await fetch('https://unpkg.com/use-m/use.js')).text())).use;
+  await ensureUseM();
 }
 
 const { $ } = await use('command-stream');

package/src/claude.lib.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-// Claude CLI-related utility functions. Fetch use-m if not available.
+import { ensureUseM } from './use-m-bootstrap.lib.mjs';
 if (typeof globalThis.use === 'undefined') {
-  globalThis.use = (await eval(await (await fetch('https://unpkg.com/use-m/use.js')).text())).use;
+  await ensureUseM();
 }
 const { $ } = await use('command-stream');
 const fs = (await use('fs')).promises;

package/src/claude.runtime-switch.lib.mjs

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
+import { ensureUseM } from './use-m-bootstrap.lib.mjs';
 // Claude runtime switching module
 // Extracted from claude.lib.mjs to maintain file line limits
 // See: docs/case-studies/issue-1141
 
 // If not, fetch it (when running standalone)
 if (typeof globalThis.use === 'undefined') {
-  globalThis.use = (await eval(await (await fetch('https://unpkg.com/use-m/use.js')).text())).use;
+  await ensureUseM();
 }
 const { $ } = await use('command-stream');
 const fs = (await use('fs')).promises;

package/src/codex.lib.mjs

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
+import { ensureUseM } from './use-m-bootstrap.lib.mjs';
 // Codex CLI-related utility functions
 
 // Check if use is already defined (when imported from solve.mjs)
 // If not, fetch it (when running standalone)
 if (typeof globalThis.use === 'undefined') {
-  globalThis.use = (await eval(await (await fetch('https://unpkg.com/use-m/use.js')).text())).use;
+  await ensureUseM();
 }
 
 const { $ } = await use('command-stream');

package/src/config.lib.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { ensureUseM } from './use-m-bootstrap.lib.mjs';
 
 /**
  * Central configuration module for all configurable values
@@ -8,7 +9,7 @@
 // Use use-m to dynamically import modules
 if (typeof globalThis.use === 'undefined') {
   try {
-    globalThis.use = (await eval(await (await fetch('https://unpkg.com/use-m/use.js')).text())).use;
+    await ensureUseM();
   } catch (error) {
     console.error('❌ Fatal error: Failed to load dependencies for configuration');
     console.error(`   ${error.message}`);

package/src/contributing-guidelines.lib.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { ensureUseM } from './use-m-bootstrap.lib.mjs';
 
 /**
  * Contributing Guidelines Detection and Fetching
@@ -6,7 +7,7 @@
  */
 
 if (typeof globalThis.use === 'undefined') {
-  globalThis.use = (await eval(await (await fetch('https://unpkg.com/use-m/use.js')).text())).use;
+  await ensureUseM();
 }
 
 const { $: __rawDollar$ } = await use('command-stream');

package/src/gemini.lib.mjs

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
+import { ensureUseM } from './use-m-bootstrap.lib.mjs';
 // Google Gemini CLI-related utility functions
 
 // Check if use is already defined (when imported from solve.mjs)
 // If not, fetch it (when running standalone)
 if (typeof globalThis.use === 'undefined') {
-  globalThis.use = (await eval(await (await fetch('https://unpkg.com/use-m/use.js')).text())).use;
+  await ensureUseM();
 }
 
 const { $ } = await use('command-stream');

package/src/github-entity-validation.lib.mjs

@@ -1,9 +1,10 @@
+import { ensureUseM } from './use-m-bootstrap.lib.mjs';
 /**
  * GitHub entity existence validation for /solve command.
  * Extracted from github.lib.mjs to keep files under 1500 line limit.
  * @see https://github.com/link-assistant/hive-mind/issues/1552
  */
-if (typeof globalThis.use === 'undefined') globalThis.use = (await eval(await (await fetch('https://unpkg.com/use-m/use.js')).text())).use;
+if (typeof globalThis.use === 'undefined') await ensureUseM();
 const { $ } = await use('command-stream');
 import { ghCmdRetry } from './lib.mjs';
 import { ghPrView, ghIssueView } from './github.lib.mjs';

package/src/github-error-reporter.lib.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { ensureUseM } from './use-m-bootstrap.lib.mjs';
 
 /**
  * GitHub error reporter - handles error reporting via GitHub issues and comments
@@ -9,7 +10,7 @@ import { log, cleanErrorMessage, getAbsoluteLogPath } from './lib.mjs';
 import { reportError, isSentryEnabled } from './sentry.lib.mjs';
 
 if (typeof globalThis.use === 'undefined') {
-  globalThis.use = (await eval(await (await fetch('https://unpkg.com/use-m/use.js')).text())).use;
+  await ensureUseM();
 }
 
 const fs = (await use('fs')).promises;

package/src/github.batch.lib.mjs

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
+import { ensureUseM } from './use-m-bootstrap.lib.mjs';
 // GitHub batch operations using GraphQL
 
 // Check if use is already defined (when imported from solve.mjs)
 // If not, fetch it (when running standalone)
 if (typeof globalThis.use === 'undefined') {
-  globalThis.use = (await eval(await (await fetch('https://unpkg.com/use-m/use.js')).text())).use;
+  await ensureUseM();
 }
 
 // Import dependencies

package/src/github.lib.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
+import { ensureUseM } from './use-m-bootstrap.lib.mjs';
 // GitHub-related utility functions. Check if use is already defined (when imported from solve.mjs), if not, fetch it (when running standalone)
-if (typeof globalThis.use === 'undefined') globalThis.use = (await eval(await (await fetch('https://unpkg.com/use-m/use.js')).text())).use;
+if (typeof globalThis.use === 'undefined') await ensureUseM();
 const { $ } = await use('command-stream'); // Use command-stream for consistent $ behavior
 import { log, maskToken, cleanErrorMessage, isENOSPC, ghCmdRetry } from './lib.mjs';
 import { reportError } from './sentry.lib.mjs';

package/src/handoff-skill.lib.mjs

@@ -1,3 +1,4 @@
+import { ensureUseM } from './use-m-bootstrap.lib.mjs';
 /**
  * HANDOFF.md Agent Skill deployment (issue #1877)
  *
@@ -29,7 +30,7 @@
 
 // Fetch use-m if not available (matches the rest of src/*.lib.mjs).
 if (typeof globalThis.use === 'undefined') {
-  globalThis.use = (await eval(await (await fetch('https://unpkg.com/use-m/use.js')).text())).use;
+  await ensureUseM();
 }
 const fs = (await use('fs')).promises;
 const path = (await use('path')).default;

package/src/hive.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 // Import Sentry instrumentation first (must be before other imports)
 import './instrument.mjs';
+import { ensureUseM } from './use-m-bootstrap.lib.mjs';
 import { wrapDollarWithGhRetry as _wrapDollarWithGhRetry, execGhWithRetry } from './github-rate-limit.lib.mjs'; // rate-limit marker (#1726): gh API calls flow through $ wrapped by caller. execGhWithRetry adds transient-network retry (#1756).
 const earlyArgs = process.argv.slice(2);
 if (earlyArgs.includes('--version')) {
@@ -42,16 +43,17 @@ if (isRunningDirectly) {
   console.log('   Initializing...');
   try {
     console.log('   Loading dependencies (this may take a moment)...');
-    // Use use-m to dynamically import modules for cross-runtime compatibility
-    if (typeof use === 'undefined') {
+    if (typeof globalThis.use === 'undefined') {
       try {
-        // Wrap fetch in timeout to prevent hanging
-        const useMCode = await withTimeout(
-          fetch('https://unpkg.com/use-m/use.js').then(r => r.text()),
-          10000,
-          'fetching use-m library'
-        );
-        globalThis.use = (await eval(useMCode)).use;
+        await ensureUseM({
+          fetchUseMCode: () =>
+            withTimeout(
+              fetch('https://unpkg.com/use-m/use.js').then(r => r.text()),
+              10000,
+              'fetching use-m library'
+            ),
+          log: message => console.log(message),
+        });
       } catch (error) {
         console.error('❌ Fatal error: Failed to load dependencies');
         console.error(`   ${error.message}`);
@@ -60,7 +62,6 @@ if (isRunningDirectly) {
         process.exit(1);
       }
     }
-    // Use command-stream for consistent $ behavior across runtimes
     const { $ } = await withTimeout(
       use('command-stream'),
       30000, // 30 second timeout

package/src/interactive-codex-events.lib.mjs

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+
+import { createCollapsible, createRawJsonSection, createRedactedRawJsonSection, escapeMarkdown, redactImageData, safeJsonStringify, truncateMiddle } from './interactive-mode.shared.lib.mjs';
+import { INTERACTIVE_SESSION_STARTED_MARKER } from './tool-comments.lib.mjs';
+
+export const createCodexEventHandlers = ({ state, postComment, handleAssistantText, imageRenderer }) => {
+  const handleCodexThreadStarted = async data => {
+    if (state.sessionId) return;
+
+    state.sessionId = data.thread_id || data.session_id || null;
+    state.startTime = Date.now();
+
+    const comment = `## 🚀 ${INTERACTIVE_SESSION_STARTED_MARKER}
+
+| Property | Value |
+|----------|-------|
+| **Session ID** | \`${state.sessionId || 'unknown'}\` |
+| **Model** | \`${data.model || 'unknown'}\` |
+| **Tool** | \`codex\` |
+
+---
+
+${createRawJsonSection(data)}`;
+
+    await postComment(comment);
+  };
+
+  const handleCodexAgentMessage = async data => {
+    const text = data.item?.text;
+    if (typeof text !== 'string' || !text.trim()) return;
+    await handleAssistantText(data, text);
+  };
+
+  const handleCodexTodoList = async data => {
+    const items = Array.isArray(data.item?.items) ? data.item.items : [];
+    const todosPreview = items.length > 0 ? items.map(todo => `- [${todo?.completed ? 'x' : ' '}] ${todo?.text || ''}`).join('\n') : '_No tasks_';
+    const completedCount = items.filter(todo => todo?.completed).length;
+
+    const comment = `## 📋 Codex todo list
+
+${createCollapsible(`📋 Todos (${completedCount}/${items.length} items)`, todosPreview, true)}
+
+---
+
+${createRawJsonSection(data)}`;
+
+    await postComment(comment);
+  };
+
+  const handleCodexCommandExecution = async data => {
+    const item = data.item || {};
+    const command = item.command || '';
+    const output = item.aggregated_output || '';
+    const status = item.status || (data.type === 'item.completed' ? 'completed' : data.type === 'item.updated' ? 'updated' : 'started');
+    const body = `## 💻 Codex command execution
+
+**Status:** \`${status}\`
+${command ? '\n' + createCollapsible('📋 Executed command', '```bash\n' + escapeMarkdown(command) + '\n```', true) : ''}
+${output ? '\n\n' + createCollapsible('📤 Output', '```\n' + escapeMarkdown(truncateMiddle(output, { maxLines: 60, keepStart: 25, keepEnd: 25 })) + '\n```', true) : ''}
+
+---
+
+${createRawJsonSection(data)}`;
+    await postComment(body);
+  };
+
+  const handleCodexMcpToolCall = async data => {
+    const item = data.item || {};
+    const summary = [`**Server:** \`${item.server || 'unknown'}\``, `**Tool:** \`${item.tool || 'unknown'}\``, `**Status:** \`${item.status || 'unknown'}\``].join('\n');
+    const details = item.arguments != null ? createCollapsible('📥 Arguments', '```json\n' + safeJsonStringify(item.arguments, 2) + '\n```', true) : '';
+    // Issue #1843: render MCP-result images inline; base64 is redacted from JSON below.
+    const imagesSection = await imageRenderer.section([item.result], `${item.tool || 'mcp'} image`);
+    const imagesBlock = imagesSection ? '\n\n' + imagesSection : '';
+    const resultSection = item.result != null ? '\n\n' + createCollapsible('📤 Result', '```json\n' + safeJsonStringify(redactImageData(item.result), 2) + '\n```', false) : '';
+    const errorSection = item.error != null ? '\n\n' + createCollapsible('❌ Error', '```json\n' + safeJsonStringify(item.error, 2) + '\n```', true) : '';
+
+    await postComment(`## 🔌 Codex MCP tool call
+
+${summary}
+${details}${resultSection}${imagesBlock}${errorSection}
+
+---
+
+${createRedactedRawJsonSection(data)}`);
+  };
+
+  const handleCodexWebSearch = async data => {
+    const item = data.item || {};
+    await postComment(`## 🌐 Codex web search
+
+**Query:** ${escapeMarkdown(item.query || 'unknown')}
+${item.action ? `\n**Action:** \`${item.action}\`` : ''}
+
+---
+
+${createRawJsonSection(data)}`);
+  };
+
+  const handleCodexFileChange = async data => {
+    const item = data.item || {};
+    const changes = Array.isArray(item.changes) ? item.changes.map(change => `- \`${change?.kind || 'change'}\` ${change?.path || ''}`).join('\n') : '_No changes listed_';
+    await postComment(`## 📝 Codex file changes
+
+**Status:** \`${item.status || 'unknown'}\`
+${createCollapsible('📄 Files', changes, true)}
+
+---
+
+${createRawJsonSection(data)}`);
+  };
+
+  const handleCodexCollabToolCall = async data => {
+    const item = data.item || {};
+    const prompt = item.prompt || item.description || `${item.tool || 'collab_tool_call'} via codex`;
+    await postComment(`## 🤝 Codex collab/sub-agent call
+
+**Tool:** \`${item.tool || 'unknown'}\`
+**Status:** \`${item.status || 'unknown'}\`
+${createCollapsible('📝 Prompt', escapeMarkdown(truncateMiddle(prompt, { maxLines: 30, keepStart: 12, keepEnd: 12 })), true)}
+
+---
+
+${createRawJsonSection(data)}`);
+  };
+
+  const handleCodexTurnCompleted = async data => {
+    const usage = data.usage || {};
+    let usageSection = '| Type | Count |\n|------|-------|\n';
+    usageSection += `| Input | ${(usage.input_tokens || 0).toLocaleString()} |\n`;
+    usageSection += `| Cache Read | ${(usage.cached_input_tokens || 0).toLocaleString()} |\n`;
+    usageSection += `| Output | ${(usage.output_tokens || 0).toLocaleString()} |\n`;
+
+    await postComment(`## ✅ Codex turn completed
+
+### 📊 Token Usage
+
+${usageSection}
+
+---
+
+${createRawJsonSection(data)}`);
+  };
+
+  const handleCodexError = async data => {
+    const message = data.message || data.error?.message || 'Unknown Codex error';
+    await postComment(`## ❌ Codex error
+
+${createCollapsible('View error', escapeMarkdown(message), true)}
+
+---
+
+${createRawJsonSection(data)}`);
+  };
+
+  return {
+    handleCodexThreadStarted,
+    handleCodexAgentMessage,
+    handleCodexTodoList,
+    handleCodexCommandExecution,
+    handleCodexMcpToolCall,
+    handleCodexWebSearch,
+    handleCodexFileChange,
+    handleCodexCollabToolCall,
+    handleCodexTurnCompleted,
+    handleCodexError,
+  };
+};