@link-assistant/hive-mind 1.74.0 → 1.74.2

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @link-assistant/hive-mind
 
+## 1.74.2
+
+### Patch Changes
+
+- d726744: Add cleanup process diagnostics for mapping agent PIDs to task sessions and stopping orphaned terminal-session agents.
+
+## 1.74.1
+
+### Patch Changes
+
+- 59eee9a: feat(interactive-mode): display images the AI reads/writes inline in PR comments (#1843)
+
+  When `--interactive-mode` posts Claude/Codex tool activity as PR comments, any
+  images the AI reads or produces (the `Read` tool on a screenshot, Playwright
+  captures, MCP image results) were previously serialized as multi-kilobyte
+  base64 blobs inside the "Raw JSON" section — unreadable and pushing comments
+  toward GitHub's size limit.
+
+  Those base64 payloads are now uploaded to hidden custom Git refs
+  (`refs/hive-mind-media/pr-...`) via the Git Data API and embedded inline in the
+  comment as commit-SHA `![](…?raw=true)` blob URLs, so reviewers see the actual
+  image (GitHub's Camo proxy renders `?raw=true` blob URLs inline for both public
+  and private repos, whereas `data:` URIs are stripped by the comment sanitizer).
+  Uploads are content-hashed (SHA-256) for dedup, and the base64 is redacted from
+  the Raw JSON section with a `<image data: N base64 chars>` placeholder.
+
+  Enabled by default; use `--no-interactive-image-upload` to opt out, in which
+  case each image degrades to a compact metadata note instead of being embedded.
+  All comment bodies continue to pass through the token sanitizer (#1745).
+
 ## 1.74.0
 
 ### Minor Changes

package/README.hi.md

@@ -746,12 +746,25 @@ cleanup --force-start-command
 # Ubuntu / सिस्टम क्लीनअप (apt कैश, journald लॉग, npm कैश)
 cleanup --system --sudo
 
+# लाइव/अटके हुए agent PID को hive/start-command कार्य सत्रों से मिलाएँ
+cleanup --processes
+
+# किसी खास non-agent PID को ट्रेस करें, जैसे browser child या shell
+cleanup --pid 94445
+
+# रोके जा सकने वाले orphaned agents का पूर्वावलोकन करें
+cleanup --kill-orphaned-agents --dry-run
+
+# पूर्वावलोकन जाँचने के बाद orphaned agent process trees रोकें
+cleanup --kill-orphaned-agents --force
+
 # सक्रिय-कार्य पहचान अक्षम करें (केवल सुरक्षित पथ रखे जाते हैं)
 cleanup --no-keep-active-tasks-folders --dry-run
 ```
 
 विकल्पों की पूरी सूची के लिए `cleanup --help` चलाएँ। यह कमांड dry-run के अनुकूल है और
-हर रन के लिए टाइमस्टैम्प वाला `cleanup-*.log` लिखता है।
+हर रन के लिए टाइमस्टैम्प वाला `cleanup-*.log` लिखता है। प्रक्रिया डायग्नोस्टिक आउटपुट
+कमांड लाइन प्रिंट करने से पहले सामान्य token आकारों को छिपाता है।
 
 ## 🔍 निगरानी और लॉगिंग
 
@@ -802,7 +815,22 @@ find docs/ -name "*.md" -exec wc -l {} + | awk '$1 > 1000 {print "ERROR: " $2 "
 
 ## सर्वर डायग्नोस्टिक्स
 
-उन स्क्रीन की पहचान करें जो संसाधन खपत करने वाली प्रक्रियाओं के पैरेंट हैं
+किसी व्यस्त `claude`, `codex`, `gemini`, `qwen`, या `opencode` PID को उसे शुरू करने
+वाले hive कार्य से जोड़ने के लिए पहले built-in process diagnostic command उपयोग करें:
+
+```bash
+# agent PID, start-command session ID, GitHub task URL, workspace, match reasons और संभावित orphaned agents दिखाएँ।
+cleanup --processes
+
+# उसी report में कोई भी PID शामिल करें।
+cleanup --pid 62220
+
+# केवल terminal task वाले orphaned agents रोकें।
+cleanup --kill-orphaned-agents --dry-run
+cleanup --kill-orphaned-agents --force
+```
+
+Manual fallback: उन स्क्रीन की पहचान करें जो संसाधन खपत करने वाली प्रक्रियाओं के पैरेंट हैं।
 
 ```bash
 TARGETS="62220 65988 63094 66606 1028071 4127023"

package/README.md

@@ -767,12 +767,25 @@ cleanup --force-start-command
 # Ubuntu / system cleanup (apt caches, journald logs, npm cache)
 cleanup --system --sudo
 
+# Map live/stuck agent PIDs back to hive/start-command task sessions
+cleanup --processes
+
+# Trace a specific non-agent PID, for example a browser child or shell
+cleanup --pid 94445
+
+# Preview orphaned terminal-session agents that can be stopped
+cleanup --kill-orphaned-agents --dry-run
+
+# Stop orphaned agent process trees after reviewing the preview
+cleanup --kill-orphaned-agents --force
+
 # Disable active-task detection (only protected paths are kept)
 cleanup --no-keep-active-tasks-folders --dry-run
 ```
 
 Run `cleanup --help` for the full list of options. The command is dry-run
-friendly and writes a timestamped `cleanup-*.log` for every run.
+friendly and writes a timestamped `cleanup-*.log` for every run. Process
+diagnostic output redacts common token shapes before printing command lines.
 
 ## 🔍 Monitoring & Logging
 
@@ -823,7 +836,25 @@ find docs/ -name "*.md" -exec wc -l {} + | awk '$1 > 1000 {print "ERROR: " $2 "
 
 ## Server diagnostics
 
-Identify screens that are parents of processes that eating the resources
+Prefer the built-in process diagnostic command when connecting a busy
+`claude`, `codex`, `gemini`, `qwen`, or `opencode` PID back to the hive task
+that launched it:
+
+```bash
+# Show agent PIDs, start-command session IDs, GitHub task URLs, workspaces,
+# match reasons, and possible orphaned terminal-session agents.
+cleanup --processes
+
+# Include an arbitrary PID in the same report.
+cleanup --pid 62220
+
+# Kill only agents whose matched start-command task is already terminal.
+cleanup --kill-orphaned-agents --dry-run
+cleanup --kill-orphaned-agents --force
+```
+
+Manual fallback: identify screens that are parents of processes that are eating
+the resources.
 
 ```bash
 TARGETS="62220 65988 63094 66606 1028071 4127023"

package/README.ru.md

@@ -749,12 +749,26 @@ cleanup --force-start-command
 # Очистка Ubuntu / системы (кэши apt, логи journald, кэш npm)
 cleanup --system --sudo
 
+# Сопоставить живые/зависшие agent PID с задачами hive/start-command
+cleanup --processes
+
+# Отследить конкретный не-agent PID, например дочерний процесс браузера или shell
+cleanup --pid 94445
+
+# Предпросмотр orphaned agents, которые можно остановить
+cleanup --kill-orphaned-agents --dry-run
+
+# Остановить деревья orphaned agent процессов после просмотра предпросмотра
+cleanup --kill-orphaned-agents --force
+
 # Отключить обнаружение активных задач (сохраняются только защищённые пути)
 cleanup --no-keep-active-tasks-folders --dry-run
 ```
 
 Запустите `cleanup --help`, чтобы увидеть полный список опций. Команда удобна для
 режима dry-run и записывает лог `cleanup-*.log` с меткой времени при каждом запуске.
+Диагностический вывод процессов скрывает распространённые формы token перед печатью
+командных строк.
 
 ## 🔍 Мониторинг и логирование
 
@@ -805,7 +819,24 @@ find docs/ -name "*.md" -exec wc -l {} + | awk '$1 > 1000 {print "ERROR: " $2 "
 
 ## Диагностика сервера
 
-Определите screen-сессии, являющиеся родительскими для процессов, потребляющих ресурсы
+Чтобы связать загруженный `claude`, `codex`, `gemini`, `qwen` или `opencode` PID с
+запустившей его задачей hive, сначала используйте встроенную диагностику процессов:
+
+```bash
+# Показать agent PID, start-command session ID, GitHub task URL, workspace,
+# причины совпадения и возможные orphaned agents.
+cleanup --processes
+
+# Включить произвольный PID в тот же отчёт.
+cleanup --pid 62220
+
+# Остановить только orphaned agents, чья задача уже завершена.
+cleanup --kill-orphaned-agents --dry-run
+cleanup --kill-orphaned-agents --force
+```
+
+Ручной fallback: определите screen-сессии, являющиеся родительскими для процессов,
+потребляющих ресурсы.
 
 ```bash
 TARGETS="62220 65988 63094 66606 1028071 4127023"

package/README.zh.md

@@ -741,12 +741,25 @@ cleanup --force-start-command
 # Ubuntu / 系统清理（apt 缓存、journald 日志、npm 缓存）
 cleanup --system --sudo
 
+# 将实时/卡住的 agent PID 映射回 hive/start-command 任务会话
+cleanup --processes
+
+# 跟踪指定的非 agent PID，例如浏览器子进程或 shell
+cleanup --pid 94445
+
+# 预览可以停止的孤立 agent
+cleanup --kill-orphaned-agents --dry-run
+
+# 审查预览后停止孤立 agent 进程树
+cleanup --kill-orphaned-agents --force
+
 # 禁用活动任务检测（仅保留受保护的路径）
 cleanup --no-keep-active-tasks-folders --dry-run
 ```
 
 运行 `cleanup --help` 查看完整的选项列表。该命令对 dry-run 友好，并为每次运行写入
-带时间戳的 `cleanup-*.log` 日志。
+带时间戳的 `cleanup-*.log` 日志。进程诊断输出会在打印命令行前遮蔽常见 token
+格式。
 
 ## 🔍 监控与日志
 
@@ -797,7 +810,22 @@ find docs/ -name "*.md" -exec wc -l {} + | awk '$1 > 1000 {print "ERROR: " $2 "
 
 ## 服务器诊断
 
-识别消耗资源的进程所属的 Screen 会话：
+将繁忙的 `claude`、`codex`、`gemini`、`qwen` 或 `opencode` PID 关联回启动它的
+hive 任务时，优先使用内置进程诊断命令：
+
+```bash
+# 显示 agent PID、start-command 会话 ID、GitHub 任务 URL、工作区、匹配原因和可能的孤立 agent。
+cleanup --processes
+
+# 在同一报告中包含任意 PID。
+cleanup --pid 62220
+
+# 只停止已完成任务中的孤立 agent。
+cleanup --kill-orphaned-agents --dry-run
+cleanup --kill-orphaned-agents --force
+```
+
+手动兜底：识别消耗资源的进程所属的 Screen 会话。
 
 ```bash
 TARGETS="62220 65988 63094 66606 1028071 4127023"

package/package.json

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

package/src/claude.lib.mjs

@@ -687,6 +687,8 @@ export const executeClaudeCommand = async params => {
         // so the comment-posting path can honor them; flags default to false.
         skipOutputSanitization: argv['dangerously-skip-output-sanitization'] === true,
         skipActiveTokensOutputSanitization: argv['dangerously-skip-active-tokens-output-sanitization'] === true,
+        // Issue #1843: upload & embed images by default; --no-interactive-image-upload opts out.
+        imageUploadEnabled: argv['interactive-image-upload'] !== false,
       });
     } else if (argv.interactiveMode) {
       await log('⚠️ Interactive mode: Disabled - missing PR info (owner/repo/prNumber)', { verbose: true });

package/src/cleanup.mjs

@@ -21,6 +21,8 @@
  *   --force-start-command         allow deleting /tmp/start-command
  *   --include-system              also consider system-owned temp entries
  *   --no-keep-dirty               allow deleting clones with unpushed changes
+ *   --processes                   map claude/codex/etc. PIDs to task sessions
+ *   --kill-orphaned-agents        signal orphaned terminal-session agents
  *   --apt --journal --docker --npm   Ubuntu/system cleanup (opt-in)
  *   --system                      shorthand for --apt --journal --npm
  *   --sudo                        prefix package-manager commands with sudo
@@ -34,7 +36,8 @@ import { promises as fsp } from 'node:fs';
 import { execSync } from 'node:child_process';
 
 import { classifyEntries, summarize, formatBytes, describeReason, buildActiveMatchers, DEFAULT_PROTECTED_NAMES } from './cleanup.lib.mjs';
-import { getTempRoot, listTempEntries, getPathSize, readFolderGitInfo, listProcessHeldPaths, getActiveTasks, removePath, runSystemCleanup } from './cleanup.os.lib.mjs';
+import { getTempRoot, listTempEntries, getPathSize, readFolderGitInfo, listProcessHeldPaths, getActiveTasks, removePath, runSystemCleanup, collectProcessDebugReport, signalOrphanedAgentTrees } from './cleanup.os.lib.mjs';
+import { formatProcessDebugReport } from './process-debug.lib.mjs';
 
 const args = process.argv.slice(2);
 
@@ -42,6 +45,32 @@ function hasFlag(...names) {
   return names.some(n => args.includes(n));
 }
 
+function getFlagValue(name) {
+  const exact = args.indexOf(name);
+  if (exact >= 0 && args[exact + 1] && !args[exact + 1].startsWith('-')) return args[exact + 1];
+  const prefix = `${name}=`;
+  const withEquals = args.find(arg => arg.startsWith(prefix));
+  return withEquals ? withEquals.slice(prefix.length) : null;
+}
+
+function getFlagValues(name) {
+  const values = [];
+  const prefix = `${name}=`;
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === name && args[i + 1] && !args[i + 1].startsWith('-')) values.push(args[i + 1]);
+    else if (arg.startsWith(prefix)) values.push(arg.slice(prefix.length));
+  }
+  return values;
+}
+
+function parsePidList(values) {
+  return values
+    .flatMap(value => String(value || '').split(','))
+    .map(value => Number(value.trim()))
+    .filter(value => Number.isInteger(value) && value > 0);
+}
+
 // ---------------------------------------------------------------------------
 // Early --version / --help handling (no heavy imports).
 // ---------------------------------------------------------------------------
@@ -75,6 +104,16 @@ Options:
   --no-sessions               Do not query '$ --status' for active sessions
   --no-resolve-branches       Do not resolve PR head branches via gh
 
+Process diagnostics:
+  --processes, --debug-processes
+                              Map claude/codex/gemini/qwen/opencode PIDs to
+                              hive-mind task sessions and workspaces
+  --pid <pid[,pid...]>        Include specific non-agent PIDs in the report
+  --kill-orphaned-agents      Signal orphaned agent processes whose task
+                              session has already reached a terminal status
+                              (dry-run unless --force is also set)
+  --signal <name>             Signal for --kill-orphaned-agents [SIGTERM]
+
 System / Ubuntu cleanup (opt-in):
   --apt                       apt-get clean / autoclean / autoremove
   --journal                   journalctl --vacuum-time=2weeks
@@ -103,6 +142,10 @@ const options = {
   keepDirty: !hasFlag('--no-keep-dirty'),
   useSessions: !hasFlag('--no-sessions'),
   resolveBranches: !hasFlag('--no-resolve-branches'),
+  debugProcesses: hasFlag('--processes', '--debug-processes'),
+  killOrphanedAgents: hasFlag('--kill-orphaned-agents'),
+  targetPids: parsePidList(getFlagValues('--pid')),
+  signal: getFlagValue('--signal') || 'SIGTERM',
   verbose: hasFlag('--verbose', '-v'),
   apt: hasFlag('--apt', '--system'),
   journal: hasFlag('--journal', '--system'),
@@ -110,6 +153,7 @@ const options = {
   npm: hasFlag('--npm', '--system'),
   sudo: hasFlag('--sudo'),
 };
+if (options.targetPids.length > 0) options.debugProcesses = true;
 
 const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
 const scriptDir = path.dirname(process.argv[1]);
@@ -156,6 +200,36 @@ async function main() {
   if (options.dryRun) await log('📝 DRY RUN — nothing will be deleted\n');
   else if (options.force) await log('⚠️  FORCE — deleting without confirmation\n');
 
+  if (options.debugProcesses || options.killOrphanedAgents) {
+    const report = await collectProcessDebugReport({ useSessions: options.useSessions, targetPids: options.targetPids });
+    await log('');
+    await log(formatProcessDebugReport(report));
+
+    if (options.killOrphanedAgents) {
+      if (report.orphans.length === 0) {
+        await log('\n✅ No orphaned terminal-session agent processes found.');
+      } else if (options.dryRun || !options.force) {
+        await log(`\n📝 Dry run: would send ${options.signal} to orphaned agent roots: ${report.orphans.map(item => item.pid).join(', ')}`);
+        await log('Re-run with --force to signal these process trees.');
+      } else {
+        await log(`\n🧯 Sending ${options.signal} to orphaned agent process trees...`);
+        const killed = signalOrphanedAgentTrees(report, { signal: options.signal, currentPid: process.pid });
+        let ok = 0;
+        let failed = 0;
+        for (const tree of killed) {
+          const pids = tree.results.map(result => `${result.pid}${result.ok ? '' : ' (failed)'}`).join(', ') || '(none)';
+          await log(`   root ${tree.rootPid}: ${pids}`);
+          ok += tree.results.filter(result => result.ok).length;
+          failed += tree.results.filter(result => !result.ok).length;
+        }
+        await log(`\n✅ Signalled ${ok} processes${failed ? `, ${failed} failed` : ''}.`);
+      }
+    }
+
+    await log(`\n📁 Log file: ${logFile}`);
+    return;
+  }
+
   // 1. Enumerate candidate entries.
   const entries = listTempEntries(tempRoot);
   await log(`🔍 Found ${entries.length} entries under ${tempRoot}`);