@evomap/evolver 1.68.0-beta.1 → 1.69.0

package/README.ja-JP.md

@@ -355,6 +355,25 @@ EVOLVE_REPORT_TOOL=feishu-card
 **方法 2: 動的検出**
 スクリプトは、互換性のあるローカルスキル（`skills/feishu-card` など）がワークスペースに存在するかを自動的に検出し、それに応じて動作をアップグレードします。
 
+### バリデータ役割（デフォルト ON）
+
+[EvoMap Hub](https://evomap.ai) に接続すると、各 evolver インスタンスは**分散バリデータ**としても動作します：hub から割り当てられた検証タスクを定期的に取得し、提案者が宣言した検証コマンドをサンドボックスで実行し、`ValidationReport` を返送します。コンセンサスに参加したバリデータはクレジットと評判を獲得します。
+
+| 変数 | デフォルト | 説明 |
+|------|-----------|------|
+| `EVOLVER_VALIDATOR_ENABLED` | _(未設定 = ON)_ | `0`/`false`/`off` でオプトアウト、`1`/`true`/`on` で強制 ON。env が hub プッシュフラグおよびコードのデフォルトより優先されます。 |
+| `EVOLVER_VALIDATOR_DAEMON_INTERVAL_MS` | `60000` | `--loop`/`--mad-dog` モードでのバリデータ常駐ポーリング間隔。 |
+| `EVOLVER_VALIDATOR_MAX_TASKS_PER_CYCLE` | `2` | ポーリングごとの最大取得タスク数。 |
+| `EVOLVER_VALIDATOR_FETCH_TIMEOUT_MS` | `8000` | 1 回のフェッチのタイムアウト。 |
+
+永続フラグの上書き：env が未設定の場合、ランタイムは `~/.evomap/feature_flags.json` を読み込みます。Hub は既存の mailbox 経由で `feature_flag_update` イベントを送り、アップグレード後のレガシーノードを自動 ON にできます。
+
+永続的にオプトアウト：
+
+```bash
+EVOLVER_VALIDATOR_ENABLED=0 evolver run --loop
+```
+
 ### GitHub Issue 自動報告
 
 evolver が持続的な失敗（失敗ループまたは高い失敗率での繰り返しエラー）を検出すると、サニタイズされた環境情報とログで GitHub issue を上流リポジトリに自動的にファイルできます。すべての機密データ（トークン、ローカルパス、メールなど）は送信前に編集されます。

package/README.md

@@ -354,6 +354,25 @@ EVOLVE_REPORT_TOOL=feishu-card
 **Method 2: Dynamic Detection**
 The script automatically detects if compatible local skills (like `skills/feishu-card`) exist in your workspace and upgrades its behavior accordingly.
 
+### Validator Role (default ON)
+
+When connected to an [EvoMap Hub](https://evomap.ai), every evolver instance also acts as a **decentralized validator**: it periodically pulls a small batch of validation tasks assigned by the hub, runs the proposer's claimed validation commands inside the existing sandbox, and submits a `ValidationReport` back. Validators that join consensus earn credits and reputation.
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `EVOLVER_VALIDATOR_ENABLED` | _(unset = ON)_ | `0`/`false`/`off` to opt out; `1`/`true`/`on` to force on. Env always wins over hub-pushed flag and the built-in default. |
+| `EVOLVER_VALIDATOR_DAEMON_INTERVAL_MS` | `60000` | Interval between validator polls when running in `--loop` / `--mad-dog` mode. |
+| `EVOLVER_VALIDATOR_MAX_TASKS_PER_CYCLE` | `2` | Max tasks claimed per poll. |
+| `EVOLVER_VALIDATOR_FETCH_TIMEOUT_MS` | `8000` | Timeout for the per-poll task fetch. |
+
+Persistent flag override: when the env is unset, the runtime reads `~/.evomap/feature_flags.json`. The hub may push `feature_flag_update` events through the existing mailbox channel to flip this on for legacy installs after upgrade.
+
+To opt out permanently:
+
+```bash
+EVOLVER_VALIDATOR_ENABLED=0 evolver run --loop
+```
+
 ### Auto GitHub Issue Reporting
 
 When the evolver detects persistent failures (failure loop or recurring errors with high failure ratio), it can automatically file a GitHub issue to the upstream repository with sanitized environment info and logs. All sensitive data (tokens, local paths, emails, etc.) is redacted before submission.

package/README.zh-CN.md

@@ -346,6 +346,25 @@ EVOLVE_REPORT_TOOL=feishu-card
 **方式二：动态检测**
 脚本会自动检测是否存在兼容的本地技能（如 `skills/feishu-card`），并自动升级行为。
 
+### 验证者角色（默认开启）
+
+当连接到 [EvoMap Hub](https://evomap.ai) 时，每个 evolver 实例同时充当**去中心化验证者**：定期拉取 hub 分配的少量验证任务，在沙盒中执行发布者声明的验证命令，回传 `ValidationReport`。参与共识的验证者会获得积分与信誉。
+
+| 变量 | 默认值 | 说明 |
+|------|--------|------|
+| `EVOLVER_VALIDATOR_ENABLED` | _（未设 = 开启）_ | `0`/`false`/`off` 主动关闭；`1`/`true`/`on` 强制开启。env 优先于 hub 下发的 flag 与代码默认值。 |
+| `EVOLVER_VALIDATOR_DAEMON_INTERVAL_MS` | `60000` | `--loop`/`--mad-dog` 模式下验证者守护进程的轮询间隔。 |
+| `EVOLVER_VALIDATOR_MAX_TASKS_PER_CYCLE` | `2` | 每次轮询最多领取的任务数。 |
+| `EVOLVER_VALIDATOR_FETCH_TIMEOUT_MS` | `8000` | 单次拉取的超时。 |
+
+持久化覆盖：未设 env 时，运行时读取 `~/.evomap/feature_flags.json`。Hub 可通过现有 mailbox 通道下发 `feature_flag_update` 事件，让升级后的老节点自动开启。
+
+永久关闭：
+
+```bash
+EVOLVER_VALIDATOR_ENABLED=0 evolver run --loop
+```
+
 ### 自动 GitHub Issue 上报
 
 当 evolver 检测到持续性失败（failure loop 或 recurring error + high failure ratio）时，会自动向上游仓库提交 GitHub issue，附带脱敏后的环境信息和日志。所有敏感数据（token、本地路径、邮箱等）在提交前均会被替换为 `[REDACTED]`。

package/index.js

@@ -206,6 +206,18 @@ async function main() {
           console.warn('[Heartbeat] Failed to start: ' + (e.message || e));
         }
 
+        // 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.
+        try {
+          const { startValidatorDaemon } = require('./src/gep/validator');
+          if (startValidatorDaemon()) {
+            console.log('[ValidatorDaemon] started.');
+          }
+        } catch (vdErr) {
+          console.warn('[ValidatorDaemon] failed to start: ' + (vdErr && vdErr.message || vdErr));
+        }
+
         // ATP: auto-start merchant agent if enabled
         try {
           const { defaultHandler, merchantAgent } = require('./src/atp');
@@ -522,6 +534,15 @@ async function main() {
       process.exit(1);
     }
     const responseFilePath = responseFileFlag.slice('--response-file='.length);
+    {
+      const { getRepoRoot } = require('./src/gep/paths');
+      const resolvedResponsePath = path.resolve(responseFilePath);
+      const resolvedRepoRoot = path.resolve(getRepoRoot());
+      if (responseFilePath.includes('..') || !resolvedResponsePath.startsWith(resolvedRepoRoot)) {
+        console.error('[Distill] ERROR: Invalid response-file path "' + responseFilePath + '" - path traversal detected or path is outside the repository.');
+        process.exit(2);
+      }
+    }
     try {
       const responseText = fs.readFileSync(responseFilePath, 'utf8');
       const { completeDistillation } = require('./src/gep/skillDistiller');
@@ -904,7 +925,16 @@ async function main() {
     - --action=<action>        (filter: hub_search_hit, hub_search_miss, asset_reuse, asset_reference, asset_publish, asset_publish_skip)
     - --last=<N>               (show last N entries)
     - --since=<ISO_date>       (entries after date)
-    - --json                   (raw JSON output)`);
+    - --json                   (raw JSON output)
+
+Validator role (decentralized validation, default ON since v1.69.0):
+  - EVOLVER_VALIDATOR_ENABLED=0    opt out (env beats persisted flag and default)
+  - EVOLVER_VALIDATOR_ENABLED=1    explicitly opt in
+  - unset                          honor persisted flag from ~/.evomap/feature_flags.json,
+                                   else default ON. The hub may push a flag update via
+                                   the mailbox (event type: feature_flag_update).
+  - Earnings: validators earn credits + reputation from successful consensus.
+    See docs/validator.md for details.`);
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evomap/evolver",
-  "version": "1.68.0-beta.1",
+  "version": "1.69.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/config.js

@@ -47,6 +47,19 @@ const MAX_REGEX_PATTERN_LEN = 1024;
 // --- Evolution Loop ---
 
 const REPAIR_LOOP_THRESHOLD = envInt('EVOLVER_REPAIR_LOOP_THRESHOLD', 3);
+
+// --- Gene Suppression (saturated / repeatedly failing genes) ---
+// These thresholds control when a Gene is forcibly excluded from selection
+// regardless of drift state. Without this, a Gene that fails repeatedly can
+// trigger plateau detection -> drift mode -> the legacy ban skip path,
+// resulting in the same failed Gene being re-selected forever.
+//
+// GENE_BAN_PER_KEY_ATTEMPTS:    minimum attempts on the same signal key
+// GENE_BAN_BEST_THRESHOLD:      best success rate at or below which the Gene is banned
+// GENE_EPIGENETIC_HARD_BOOST:   epigenetic boost at or below which the Gene is hard-suppressed
+const GENE_BAN_PER_KEY_ATTEMPTS = envInt('EVOLVER_GENE_BAN_PER_KEY_ATTEMPTS', 4);
+const GENE_BAN_BEST_THRESHOLD = envFloat('EVOLVER_GENE_BAN_BEST_THRESHOLD', 0.15);
+const GENE_EPIGENETIC_HARD_BOOST = envFloat('EVOLVER_GENE_EPIGENETIC_HARD_BOOST', -0.3);
 const SESSION_ARCHIVE_TRIGGER = envInt('EVOLVER_SESSION_ARCHIVE_TRIGGER', 100);
 const SESSION_ARCHIVE_KEEP = envInt('EVOLVER_SESSION_ARCHIVE_KEEP', 50);
 const MEMORY_FRAGMENT_MAX_CHARS = envInt('EVOLVER_MEMORY_FRAGMENT_MAX_CHARS', 50000);
@@ -123,6 +136,9 @@ module.exports = {
   MAX_REGEX_PATTERN_LEN,
   // Evolution
   REPAIR_LOOP_THRESHOLD,
+  GENE_BAN_PER_KEY_ATTEMPTS,
+  GENE_BAN_BEST_THRESHOLD,
+  GENE_EPIGENETIC_HARD_BOOST,
   SESSION_ARCHIVE_TRIGGER,
   SESSION_ARCHIVE_KEEP,
   MEMORY_FRAGMENT_MAX_CHARS,