@evomap/evolver 1.78.10 → 1.79.1

package/README.ja-JP.md

@@ -4,6 +4,7 @@
 [![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](https://opensource.org/licenses/GPL-3.0)
 [![Node.js >= 18](https://img.shields.io/badge/Node.js-%3E%3D%2018-green.svg)](https://nodejs.org/)
 [![GitHub last commit](https://img.shields.io/github/last-commit/EvoMap/evolver)](https://github.com/EvoMap/evolver/commits/main)
+[![npm downloads](https://img.shields.io/npm/dm/@evomap/evolver.svg)](https://www.npmjs.com/package/@evomap/evolver)
 [![GitHub issues](https://img.shields.io/github/issues/EvoMap/evolver)](https://github.com/EvoMap/evolver/issues)
 [![arXiv](https://img.shields.io/badge/arXiv-2604.15097-b31b1b.svg)](https://arxiv.org/abs/2604.15097)
 

package/README.ko-KR.md

@@ -4,6 +4,7 @@
 [![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](https://opensource.org/licenses/GPL-3.0)
 [![Node.js >= 18](https://img.shields.io/badge/Node.js-%3E%3D%2018-green.svg)](https://nodejs.org/)
 [![GitHub last commit](https://img.shields.io/github/last-commit/EvoMap/evolver)](https://github.com/EvoMap/evolver/commits/main)
+[![npm downloads](https://img.shields.io/npm/dm/@evomap/evolver.svg)](https://www.npmjs.com/package/@evomap/evolver)
 [![GitHub issues](https://img.shields.io/github/issues/EvoMap/evolver)](https://github.com/EvoMap/evolver/issues)
 [![arXiv](https://img.shields.io/badge/arXiv-2604.15097-b31b1b.svg)](https://arxiv.org/abs/2604.15097)
 

package/README.md

@@ -4,6 +4,7 @@
 [![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](https://opensource.org/licenses/GPL-3.0)
 [![Node.js >= 18](https://img.shields.io/badge/Node.js-%3E%3D%2018-green.svg)](https://nodejs.org/)
 [![GitHub last commit](https://img.shields.io/github/last-commit/EvoMap/evolver)](https://github.com/EvoMap/evolver/commits/main)
+[![npm downloads](https://img.shields.io/npm/dm/@evomap/evolver.svg)](https://www.npmjs.com/package/@evomap/evolver)
 [![GitHub issues](https://img.shields.io/github/issues/EvoMap/evolver)](https://github.com/EvoMap/evolver/issues)
 [![arXiv](https://img.shields.io/badge/arXiv-2604.15097-b31b1b.svg)](https://arxiv.org/abs/2604.15097)
 

package/README.zh-CN.md

@@ -4,6 +4,7 @@
 [![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](https://opensource.org/licenses/GPL-3.0)
 [![Node.js >= 18](https://img.shields.io/badge/Node.js-%3E%3D%2018-green.svg)](https://nodejs.org/)
 [![GitHub last commit](https://img.shields.io/github/last-commit/EvoMap/evolver)](https://github.com/EvoMap/evolver/commits/main)
+[![npm downloads](https://img.shields.io/npm/dm/@evomap/evolver.svg)](https://www.npmjs.com/package/@evomap/evolver)
 [![GitHub issues](https://img.shields.io/github/issues/EvoMap/evolver)](https://github.com/EvoMap/evolver/issues)
 [![arXiv](https://img.shields.io/badge/arXiv-2604.15097-b31b1b.svg)](https://arxiv.org/abs/2604.15097)
 

package/assets/gep/candidates.jsonl

@@ -1 +1,2 @@
-{"type":"CapabilityCandidate","id":"cand_b9a66a5c","title":"Harden session log detection and fallback behavior","source":"signals","created_at":"2026-05-05T01:31:11.544Z","signals":["memory_missing","user_missing","session_logs_missing"],"tags":["memory_missing","user_missing","session_logs_missing","area:memory"],"shape":{"title":"Harden session log detection and fallback behavior","input":"Recent session transcript + memory snippets + user instructions","output":"A safe, auditable evolution patch guided by GEP assets","invariants":"Protocol order, small reversible patches, validation, append-only events","params":"Signals: memory_missing, user_missing, session_logs_missing","failure_points":"Missing signals, over-broad changes, skipped validation, missing knowledge solidification","evidence":"Signal present: session_logs_missing"}}
+{"type":"CapabilityCandidate","id":"cand_b9a66a5c","title":"Harden session log detection and fallback behavior","source":"signals","created_at":"2026-05-06T01:46:54.543Z","signals":["memory_missing","user_missing","session_logs_missing"],"tags":["memory_missing","user_missing","session_logs_missing","area:memory"],"shape":{"title":"Harden session log detection and fallback behavior","input":"Recent session transcript + memory snippets + user instructions","output":"A safe, auditable evolution patch guided by GEP assets","invariants":"Protocol order, small reversible patches, validation, append-only events","params":"Signals: memory_missing, user_missing, session_logs_missing","failure_points":"Missing signals, over-broad changes, skipped validation, missing knowledge solidification","evidence":"Signal present: session_logs_missing"}}
+{"type":"CapabilityCandidate","id":"cand_b9a66a5c","title":"Harden session log detection and fallback behavior","source":"signals","created_at":"2026-05-06T01:47:23.332Z","signals":["memory_missing","user_missing","session_logs_missing"],"tags":["memory_missing","user_missing","session_logs_missing","area:memory"],"shape":{"title":"Harden session log detection and fallback behavior","input":"Recent session transcript + memory snippets + user instructions","output":"A safe, auditable evolution patch guided by GEP assets","invariants":"Protocol order, small reversible patches, validation, append-only events","params":"Signals: memory_missing, user_missing, session_logs_missing","failure_points":"Missing signals, over-broad changes, skipped validation, missing knowledge solidification","evidence":"Signal present: session_logs_missing"}}

package/index.js

@@ -104,6 +104,79 @@ function parseMs(v, fallback) {
   return fallback;
 }
 
+function parseBoolEnv(v, fallback) {
+  if (v == null) return fallback;
+  const s = String(v).toLowerCase().trim();
+  if (s === '' ) return fallback;
+  if (s === 'false' || s === '0' || s === 'off' || s === 'no') return false;
+  if (s === 'true' || s === '1' || s === 'on' || s === 'yes') return true;
+  return fallback;
+}
+
+class CycleTimeoutError extends Error {
+  constructor(timeoutMs, phase, cycleNum) {
+    super('Cycle hard-timeout exceeded after ' + timeoutMs + 'ms (cycle=' + cycleNum + ', phase=' + phase + ')');
+    this.name = 'CycleTimeoutError';
+    this.code = 'CYCLE_TIMEOUT';
+    this.timeoutMs = timeoutMs;
+    this.phase = phase;
+    this.cycleNum = cycleNum;
+  }
+}
+
+// Issue #528: on Windows, child_process.spawn(detached: true, windowsHide: true)
+// allocates a new conhost window every time -- windowsHide is silently ignored
+// in detached mode. So suicide-respawn (cycles >= max, RSS over budget, or the
+// new cycle hard-timeout) opens a new cmd popup on every restart. We now skip
+// the in-process detached spawn on Windows by default and rely on an external
+// supervisor (feishu-evolver-wrapper >= 1.10.0, NSSM, pm2-windows, etc.) to
+// respawn the daemon on non-zero exit. Users who insist can opt back in with
+// EVOLVER_SUICIDE_WINDOWS=true (and accept the popups).
+function spawnReplacementProcess({ reason, args, logPath }) {
+  const isWindows = process.platform === 'win32';
+  const allowOnWindows = parseBoolEnv(process.env.EVOLVER_SUICIDE_WINDOWS, false);
+  if (isWindows && !allowOnWindows) {
+    console.log(
+      '[Daemon] Skipping in-process respawn on Windows (' + reason + '). ' +
+      'Native Node spawn(detached, windowsHide) opens a cmd popup on every restart (Issue #528). ' +
+      'Set EVOLVER_SUICIDE_WINDOWS=true to opt back in. ' +
+      'Recommended: run evolver under feishu-evolver-wrapper >= 1.10.0, NSSM, or pm2-windows so the supervisor restarts on exit.'
+    );
+    return { spawned: false, reason: 'windows_default_skip' };
+  }
+  try {
+    const logFd = fs.openSync(logPath, 'a');
+    const spawnOpts = {
+      detached: true,
+      stdio: ['ignore', logFd, logFd],
+      env: process.env,
+      windowsHide: true,
+    };
+    const child = spawn(process.execPath, [__filename, ...args], spawnOpts);
+    child.unref();
+    return { spawned: true };
+  } catch (e) {
+    console.error('[Daemon] Spawn-replacement failed (' + reason + '): ' + (e && e.message || e));
+    return { spawned: false, reason: 'spawn_error', error: e };
+  }
+}
+
+// Atomic write of the cycle_progress.json file. Wrapper polls this file every
+// 60s; if updated_at goes stale beyond EVOLVE_INNER_STUCK_TIMEOUT_SEC the
+// wrapper treats the inner core as zombie and SIGKILLs it. See Issue #19 (the
+// 22-day stuck-cycle incident) and the cross-repo timeout plan for context.
+function writeCycleProgressAtomic(progressPath, fields) {
+  try {
+    const data = Object.assign({}, fields, { updated_at: Date.now() });
+    const tmp = progressPath + '.tmp.' + process.pid;
+    fs.writeFileSync(tmp, JSON.stringify(data, null, 2) + '\n', 'utf8');
+    fs.renameSync(tmp, progressPath);
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
 function getLastSignals(statePath) {
   try {
     const st = readJsonSafe(statePath);
@@ -255,6 +328,7 @@ async function main() {
 
         const { getEvolutionDir, getEvolverLogPath } = require('./src/gep/paths');
         const solidifyStatePath = path.join(getEvolutionDir(), 'evolution_solidify_state.json');
+        const cycleProgressPath = path.join(getEvolutionDir(), 'cycle_progress.json');
 
         const minSleepMs = parseMs(process.env.EVOLVER_MIN_SLEEP_MS, 2000);
         const maxSleepMs = parseMs(process.env.EVOLVER_MAX_SLEEP_MS, 300000);
@@ -270,6 +344,15 @@ async function main() {
         const maxRssMb = parseMs(process.env.EVOLVER_MAX_RSS_MB, 500) || 500;
         const suicideEnabled = String(process.env.EVOLVER_SUICIDE || '').toLowerCase() !== 'false';
 
+        // Issue #19: hard timeout around evolve.run() to break out of zombie
+        // cycles (e.g. unclosed socket / stuck LLM call). On timeout we throw
+        // CycleTimeoutError, log diagnostic stderr, and force suicide-respawn
+        // so the wrapper sees a fresh PID + cycle. Also write cycle_progress
+        // every progressUpdateMs so the wrapper has a true heartbeat to poll.
+        const cycleTimeoutEnabled = parseBoolEnv(process.env.EVOLVER_CYCLE_TIMEOUT_ENABLED, true);
+        const cycleTimeoutMs = parseMs(process.env.EVOLVER_CYCLE_TIMEOUT_MS, 2700000); // 45 min default
+        const progressUpdateMs = parseMs(process.env.EVOLVER_PROGRESS_UPDATE_MS, 60000); // 1 min default
+
         // Start hub heartbeat (keeps node alive independently of evolution cycles)
         try {
           if (process.env.EVOMAP_PROXY === '1' || process.env.A2A_TRANSPORT === 'mailbox') {
@@ -388,8 +471,46 @@ async function main() {
 
           const t0 = Date.now();
           let ok = false;
+          // Issue #19: write progress at cycle start, refresh it every
+          // progressUpdateMs (default 60s) while evolve.run() is active, and
+          // wrap evolve.run() with Promise.race(timeout) so a hung internal
+          // call cannot freeze the daemon for days.
+          writeCycleProgressAtomic(cycleProgressPath, {
+            pid: process.pid,
+            outer_cycle: cycleCount,
+            inner_cycle: cycleCount,
+            started_at: t0,
+            phase: 'evolve.run',
+          });
+          let progressTicker = null;
+          if (progressUpdateMs > 0) {
+            progressTicker = setInterval(function () {
+              writeCycleProgressAtomic(cycleProgressPath, {
+                pid: process.pid,
+                outer_cycle: cycleCount,
+                inner_cycle: cycleCount,
+                started_at: t0,
+                phase: 'evolve.run',
+              });
+            }, progressUpdateMs);
+            if (typeof progressTicker.unref === 'function') progressTicker.unref();
+          }
+          let cycleTimeoutHandle = null;
+          let cycleTimedOut = false;
           try {
-            await evolve.run();
+            const evolvePromise = evolve.run();
+            if (cycleTimeoutEnabled && cycleTimeoutMs > 0) {
+              const timeoutPromise = new Promise(function (_, reject) {
+                cycleTimeoutHandle = setTimeout(function () {
+                  cycleTimedOut = true;
+                  reject(new CycleTimeoutError(cycleTimeoutMs, 'evolve.run', cycleCount));
+                }, cycleTimeoutMs);
+                if (cycleTimeoutHandle && typeof cycleTimeoutHandle.unref === 'function') cycleTimeoutHandle.unref();
+              });
+              await Promise.race([evolvePromise, timeoutPromise]);
+            } else {
+              await evolvePromise;
+            }
             ok = true;
 
             if (String(process.env.EVOLVE_BRIDGE || '').toLowerCase() === 'false') {
@@ -403,7 +524,29 @@ async function main() {
             }
           } catch (error) {
             const msg = error && error.message ? String(error.message) : String(error);
+            if (error && error.code === 'CYCLE_TIMEOUT') {
+              console.error('[Daemon] ' + msg);
+              if (progressTicker) { clearInterval(progressTicker); progressTicker = null; }
+              if (cycleTimeoutHandle) { clearTimeout(cycleTimeoutHandle); cycleTimeoutHandle = null; }
+              writeCycleProgressAtomic(cycleProgressPath, {
+                pid: process.pid,
+                outer_cycle: cycleCount,
+                inner_cycle: cycleCount,
+                started_at: t0,
+                phase: 'cycle_timeout_respawn',
+              });
+              spawnReplacementProcess({
+                reason: 'cycle_hard_timeout',
+                args: args,
+                logPath: getEvolverLogPath(),
+              });
+              releaseLock();
+              process.exit(1);
+            }
             console.error(`Evolution cycle failed: ${msg}`);
+          } finally {
+            if (progressTicker) { clearInterval(progressTicker); progressTicker = null; }
+            if (cycleTimeoutHandle) { clearTimeout(cycleTimeoutHandle); cycleTimeoutHandle = null; }
           }
           const dt = Date.now() - t0;
 
@@ -451,25 +594,32 @@ async function main() {
             if (isVerbose) console.warn('[OMLS] Scheduler error: ' + (e.message || e));
           }
 
-          // Suicide check (memory leak protection)
+          // Suicide check (memory leak protection). On Windows the
+          // in-process respawn opens a cmd popup (Issue #528), so by default
+          // we delegate to an external supervisor by exiting with a non-zero
+          // code instead. See spawnReplacementProcess() for the policy.
           if (suicideEnabled) {
             const memMb = process.memoryUsage().rss / 1024 / 1024;
             if (cycleCount >= maxCyclesPerProcess || memMb > maxRssMb) {
               console.log(`[Daemon] Restarting self (cycles=${cycleCount}, rssMb=${memMb.toFixed(0)})`);
-              try {
-                const logFd = fs.openSync(getEvolverLogPath(), 'a');
-                const spawnOpts = {
-                  detached: true,
-                  stdio: ['ignore', logFd, logFd],
-                  env: process.env,
-                  windowsHide: true,
-                };
-                const child = spawn(process.execPath, [__filename, ...args], spawnOpts);
-                child.unref();
+              const result = spawnReplacementProcess({
+                reason: 'max_cycles_or_rss',
+                args: args,
+                logPath: getEvolverLogPath(),
+              });
+              if (result.spawned) {
                 releaseLock();
                 process.exit(0);
-              } catch (spawnErr) {
-                console.error('[Daemon] Spawn failed, continuing current process:', spawnErr.message);
+              } else if (result.reason === 'windows_default_skip') {
+                console.log('[Daemon] Exiting with code 1 to let external supervisor respawn.');
+                releaseLock();
+                process.exit(1);
+              } else {
+                // Non-Windows spawn error: keep the lock and fall through to
+                // the next iteration of the loop instead of leaving the daemon
+                // dead. This matches the pre-1.79.1 behavior where a failed
+                // spawn was logged and the process continued running.
+                console.error('[Daemon] Spawn failed, continuing current process.');
               }
             }
           }
@@ -496,6 +646,13 @@ async function main() {
             const signals = getLastSignals(solidifyStatePath).join(',');
             console.log(`[Verbose] cycle=${cycleCount} ok=${ok} dt=${dt}ms sleep=${totalSleepMs}ms (base=${currentSleepMs} jitter=${jitter} sat=${saturationMultiplier}x) rss=${memMb}MB signals=[${signals}]`);
           }
+          writeCycleProgressAtomic(cycleProgressPath, {
+            pid: process.pid,
+            outer_cycle: cycleCount,
+            inner_cycle: cycleCount,
+            started_at: t0,
+            phase: 'sleep',
+          });
           await sleepMs(totalSleepMs);
 
           } catch (loopErr) {
@@ -1581,4 +1738,8 @@ module.exports = {
   readJsonSafe,
   rejectPendingRun,
   isPendingSolidify,
+  parseBoolEnv,
+  CycleTimeoutError,
+  writeCycleProgressAtomic,
+  spawnReplacementProcess,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evomap/evolver",
-  "version": "1.78.10",
+  "version": "1.79.1",
   "description": "A GEP-powered self-evolution engine for AI agents. Features automated log analysis and Genome Evolution Protocol (GEP) for auditable, reusable evolution assets.",
   "main": "index.js",
   "bin": {