@evomap/evolver 1.89.20 → 1.91.0

package/README.ja-JP.md

@@ -1,6 +1,6 @@
 # 🧬 Evolver
 
-[![GitHub stars](https://img.shields.io/badge/Stars-8.8k-2b3137?logo=github&logoColor=white)](https://github.com/EvoMap/evolver/stargazers)
+[![GitHub stars](https://img.shields.io/badge/Stars-8.9k-2b3137?logo=github&logoColor=white)](https://github.com/EvoMap/evolver/stargazers)
 [![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/)
 [![npm downloads](https://img.shields.io/npm/dm/@evomap/evolver.svg)](https://www.npmjs.com/package/@evomap/evolver)

package/README.ko-KR.md

@@ -1,6 +1,6 @@
 # 🧬 Evolver
 
-[![GitHub stars](https://img.shields.io/badge/Stars-8.8k-2b3137?logo=github&logoColor=white)](https://github.com/EvoMap/evolver/stargazers)
+[![GitHub stars](https://img.shields.io/badge/Stars-8.9k-2b3137?logo=github&logoColor=white)](https://github.com/EvoMap/evolver/stargazers)
 [![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/)
 [![npm downloads](https://img.shields.io/npm/dm/@evomap/evolver.svg)](https://www.npmjs.com/package/@evomap/evolver)

package/README.md

@@ -1,6 +1,6 @@
 # 🧬 Evolver
 
-[![GitHub stars](https://img.shields.io/badge/Stars-8.8k-2b3137?logo=github&logoColor=white)](https://github.com/EvoMap/evolver/stargazers)
+[![GitHub stars](https://img.shields.io/badge/Stars-8.9k-2b3137?logo=github&logoColor=white)](https://github.com/EvoMap/evolver/stargazers)
 [![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/)
 [![npm downloads](https://img.shields.io/npm/dm/@evomap/evolver.svg)](https://www.npmjs.com/package/@evomap/evolver)

package/README.zh-CN.md

@@ -1,6 +1,6 @@
 # 🧬 Evolver
 
-[![GitHub stars](https://img.shields.io/badge/Stars-8.8k-2b3137?logo=github&logoColor=white)](https://github.com/EvoMap/evolver/stargazers)
+[![GitHub stars](https://img.shields.io/badge/Stars-8.9k-2b3137?logo=github&logoColor=white)](https://github.com/EvoMap/evolver/stargazers)
 [![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/)
 [![npm downloads](https://img.shields.io/npm/dm/@evomap/evolver.svg)](https://www.npmjs.com/package/@evomap/evolver)

package/index.js

@@ -833,7 +833,32 @@ function refuseHelloIfDaemonRunning(toolLabel) {
 async function main() {
   const args = process.argv.slice(2);
   const command = args[0];
-  const isLoop = args.includes('--loop') || args.includes('--mad-dog');
+  // Solo mode (--solo): the "constrained wild" profile. Implies loop (a solo
+  // run IS a Mad Dog loop) but hard-cuts the network + ATP, snapshots the
+  // target repo each cycle and rolls back on failure, and circuit-breaks on
+  // repeated failures instead of blind-respawning. It is a NEW side path — the
+  // wild --mad-dog / controlled-daemon behavior below is untouched when isSolo
+  // is false.
+  const isSolo = args.includes('--solo');
+  const isLoop = args.includes('--loop') || args.includes('--mad-dog') || isSolo;
+  // Solo lockdown: hard-cut network + autonomous spend at the SOURCE, in-process,
+  // before any module reads these envs. The block-level `if (!isSolo)` gates
+  // below are belt-and-suspenders for the startup path; THIS is what also closes
+  // the in-cycle paths (src/evolve/guards.js starts autoBuyer/autoDeliver from
+  // inside evolve.run()) and the validator daemon (network + staked credits).
+  // These are overwrites, not defaults — a user cannot re-enable ATP/hub/validator
+  // under --solo by setting the env themselves. That is the "no escape valve" the
+  // boss pinned. Numeric knobs (e.g. EVOLVER_SOLO_MAX_FAILS) stay tunable; the
+  // four safety cuts do not.
+  if (isSolo) {
+    process.env.A2A_HUB_URL = '';
+    process.env.EVOMAP_HUB_URL = '';
+    process.env.EVOLVER_ATP = 'off';           // getAtpMode() → 'off'
+    process.env.EVOLVER_ATP_AUTOBUY = 'off';    // getConsent() → disabled (env wins over ack)
+    process.env.EVOLVER_ATP_AUTODELIVER = 'off';
+    process.env.EVOLVER_VALIDATOR_ENABLED = 'false';
+    process.env.EVOMAP_PROXY = '0';
+  }
   const isVerbose = args.includes('--verbose') || args.includes('-v') ||
     String(process.env.EVOLVER_VERBOSE || '').toLowerCase() === 'true';
   if (isVerbose) process.env.EVOLVER_VERBOSE = 'true';
@@ -1414,6 +1439,9 @@ async function main() {
         const progressUpdateMs = parseMs(process.env.EVOLVER_PROGRESS_UPDATE_MS, 60000); // 1 min default
 
         // Start hub heartbeat (keeps node alive independently of evolution cycles)
+        if (isSolo) {
+          console.log('[Solo] 断网模式：不连 hub，不启心跳/SSE/proxy/validator，仅本地自进化。');
+        } else {
         try {
           if (process.env.EVOMAP_PROXY === '1' || process.env.A2A_TRANSPORT === 'mailbox') {
             const { startProxy } = require('./src/proxy');
@@ -1464,6 +1492,7 @@ async function main() {
         } catch (e) {
           console.warn('[Heartbeat] Failed to start: ' + (e.message || e));
         }
+        }
 
         // RecallVerify worker: starts once per process; drains the publish-
         // verification queue with backoff. unref'd so it never blocks exit.
@@ -1478,6 +1507,9 @@ async function main() {
         // Validator daemon: independent timer that fetches and executes
         // validation tasks regardless of the main evolve loop's idle gating.
         // Honors EVOLVER_VALIDATOR_ENABLED and the persisted feature flag.
+        // Solo: skip entirely — the validator uses network + staked credits, and
+        // its daemon timer arms even when disabled, so don't even construct it.
+        if (!isSolo) {
         try {
           const { startValidatorDaemon } = require('./src/gep/validator');
           if (startValidatorDaemon()) {
@@ -1486,6 +1518,7 @@ async function main() {
         } catch (vdErr) {
           console.warn('[ValidatorDaemon] failed to start: ' + (vdErr && vdErr.message || vdErr));
         }
+        }
 
         // OAuth token auto-refresh: if a device-flow OAuth token is present,
         // keep it fresh in the background so long-running `evolver run` loops
@@ -1501,6 +1534,9 @@ async function main() {
         }
 
         // ATP: auto-start merchant agent if enabled
+        if (isSolo) {
+          console.log('[Solo] 禁 ATP：不加载自治交易模块，不碰花钱通道。');
+        } else {
         try {
           const { defaultHandler, merchantAgent } = require('./src/atp');
           const atpMode = defaultHandler.getAtpMode();
@@ -1607,6 +1643,7 @@ async function main() {
         } catch (autoBuyInitErr) {
           console.warn('[ATP-AutoBuyer] Init failed: ' + (autoBuyInitErr && autoBuyInitErr.message || autoBuyInitErr));
         }
+        }
 
         // Hoist module refs used inside the loop to avoid repeated module lookups per cycle
         const idleScheduler = require('./src/gep/idleScheduler');
@@ -1614,6 +1651,22 @@ async function main() {
         const { autoDistillLlm } = require('./src/gep/autoDistillLlm'); // P3: autonomous LLM distillation (shadow-first, off by default)
         const { tryExplore } = require('./src/gep/explore');
 
+        // Solo-mode setup (--solo): git safety net + circuit breaker. repoRoot is
+        // the TARGET project being evolved (getRepoRoot), NOT evolver's own source.
+        const gitGuard = isSolo ? require('./src/solo/gitGuard') : null;
+        const soloBreaker = isSolo ? require('./src/solo/breaker') : null;
+        const soloRepoRoot = isSolo ? require('./src/gep/paths').getRepoRoot() : null;
+        const soloMaxConsecutiveFailures = Math.max(1, parseMs(process.env.EVOLVER_SOLO_MAX_FAILS, 5) || 5);
+        let soloBreakerState = { consecutiveFailures: 0 };
+        if (isSolo) {
+          console.log('════════════════════════════════════════════════════════');
+          console.log('[Solo] Mad Dog · 受约束的野性模式已启动');
+          console.log('[Solo] 兜底四道：断网 · 禁ATP · 每 cycle git 快照/失败回滚 · 连续失败熔断');
+          console.log('[Solo] 默认免人审。目标仓：' + soloRepoRoot);
+          console.log('[Solo] 无 hub 审计，仅本地 git 可追溯。');
+          console.log('════════════════════════════════════════════════════════');
+        }
+
         let currentSleepMs = minSleepMs;
         let cycleCount = 0;
 
@@ -1630,6 +1683,9 @@ async function main() {
 
           const t0 = Date.now();
           let ok = false;
+          // Solo: snapshot the target repo before the cycle self-modifies it, so
+          // a failed cycle can be rolled back to this exact point.
+          const soloSnap = isSolo ? gitGuard.snapshot(soloRepoRoot) : null;
           // 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
@@ -1715,6 +1771,23 @@ async function main() {
           }
           const dt = Date.now() - t0;
 
+          // Solo: on a failed cycle, roll the target repo back to the pre-cycle
+          // snapshot (undo the broken self-edit) and advance the circuit breaker;
+          // a good cycle resets it. The breaker trip (exit) is enforced just
+          // before the suicide block below.
+          if (isSolo) {
+            const b = soloBreaker.step(soloBreakerState, ok, soloMaxConsecutiveFailures);
+            soloBreakerState = b.state;
+            if (!ok) {
+              const rolledBack = gitGuard.rollbackTo(soloRepoRoot, soloSnap);
+              if (rolledBack) {
+                console.warn('[Solo] cycle 失败，已 git 回滚目标仓到 ' + String(soloSnap).slice(0, 12) + ' (连续失败 ' + soloBreakerState.consecutiveFailures + '/' + soloMaxConsecutiveFailures + ')');
+              } else {
+                console.error('[Solo] cycle 失败且回滚未成功（无快照或 git 出错）。连续失败 ' + soloBreakerState.consecutiveFailures + '/' + soloMaxConsecutiveFailures);
+              }
+            }
+          }
+
           // Adaptive sleep: treat very fast cycles as "idle", backoff; otherwise reset to min.
           if (!ok || dt < idleThresholdMs) {
             currentSleepMs = Math.min(maxSleepMs, Math.max(minSleepMs, currentSleepMs * 2));
@@ -1790,6 +1863,17 @@ async function main() {
             if (isVerbose) console.warn('[OMLS] Scheduler error: ' + (e.message || e));
           }
 
+          // Solo circuit breaker: replace the wild loop's blind sleep-and-retry
+          // with a hard stop after N consecutive failures. Stopping (exit 1) —
+          // rather than respawning — is the point: a solo run that keeps failing
+          // must not thrash forever. An external supervisor may restart it, but
+          // the process itself refuses to blind-loop.
+          if (isSolo && soloBreakerState.consecutiveFailures >= soloMaxConsecutiveFailures) {
+            console.error('[Solo] 连续失败 ' + soloBreakerState.consecutiveFailures + ' 次达阈值，熔断停机（非盲重生）。');
+            releaseLock();
+            process.exit(1);
+          }
+
           // 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evomap/evolver",
-  "version": "1.89.20",
+  "version": "1.91.0",
   "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": {

package/src/adapters/claudeCode.js

@@ -78,13 +78,13 @@ function buildClaudeMdSection() {
 ## Evolution Memory (Evolver)
 
 This project uses evolver for self-evolution. Hooks automatically:
-1. Inject recent evolution memory at session start
+1. Run quietly at session start and load recent evolution memory when useful
 2. Detect evolution signals during file edits
 3. Record outcomes at session end
-4. (Opt-in) Surface matching distilled capabilities for each prompt — set
+4. (Opt-in) Surface matching distilled capabilities for each prompt - set
    \`EVOLVER_RECALL_MODE=shadow\` to preview, \`enforce\` to inject (default off).
 
-For substantive tasks, call \`gep_recall\` before work and \`gep_record_outcome\` after.
+Use Evolver context only when it is directly relevant. Do not narrate routine Evolver checks, hook status, or empty recall/search results to the user.
 Signals: log_error, perf_bottleneck, user_feature_request, capability_gap, deployment_issue, test_failure.`;
 }
 

package/src/adapters/codex.js

@@ -90,11 +90,11 @@ function buildAgentsMdSection() {
 ## Evolution Memory (Evolver)
 
 This project uses evolver for self-evolution. Hooks automatically:
-1. Inject recent evolution memory at session start
+1. Run quietly at session start and load recent evolution memory when useful
 2. Detect evolution signals during file edits
 3. Record outcomes at session end
 
-For substantive tasks, call \`gep_recall\` before work and \`gep_record_outcome\` after.
+Use Evolver context only when it is directly relevant. Do not narrate routine Evolver checks, hook status, or empty recall/search results to the user.
 Signals: log_error, perf_bottleneck, user_feature_request, capability_gap, deployment_issue, test_failure.`;
 }
 

package/src/adapters/kiro.js

@@ -67,11 +67,11 @@ function buildAgentsMdSection() {
 ## Evolution Memory (Evolver)
 
 This project uses evolver for self-evolution. Hooks automatically:
-1. Inject recent evolution memory on prompt submit
+1. Run quietly on prompt submit and load recent evolution memory when useful
 2. Detect evolution signals during file edits
 3. Record outcomes at session end
 
-For substantive tasks, call \`gep_recall\` before work and \`gep_record_outcome\` after.
+Use Evolver context only when it is directly relevant. Do not narrate routine Evolver checks, hook status, or empty recall/search results to the user.
 Signals: log_error, perf_bottleneck, user_feature_request, capability_gap, deployment_issue, test_failure.`;
 }
 

package/src/adapters/opencode.js

@@ -82,11 +82,11 @@ function buildAgentsMdSection() {
 ## Evolution Memory (Evolver)
 
 This project uses evolver for self-evolution. Hooks automatically:
-1. Inject recent evolution memory at session start
+1. Run quietly at session start and load recent evolution memory when useful
 2. Detect evolution signals during file edits
 3. Record outcomes at session end
 
-For substantive tasks, call \`gep_recall\` before work and \`gep_record_outcome\` after.
+Use Evolver context only when it is directly relevant. Do not narrate routine Evolver checks, hook status, or empty recall/search results to the user.
 Signals: log_error, perf_bottleneck, user_feature_request, capability_gap, deployment_issue, test_failure.`;
 }