@evomap/evolver 1.68.0-beta.2 → 1.69.1

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');
@@ -775,9 +787,30 @@ async function main() {
       const data = await resp.json();
       const outFlag = args.find(a => typeof a === 'string' && a.startsWith('--out='));
       const safeId = String(data.skill_id || skillId).replace(/[^a-zA-Z0-9_\-\.]/g, '_');
-      const outDir = outFlag
-        ? outFlag.slice('--out='.length)
-        : path.join('.', 'skills', safeId);
+      let outDir;
+      if (outFlag) {
+        const rawOut = outFlag.slice('--out='.length);
+        if (!rawOut || rawOut.trim() === '') {
+          console.error('[fetch] --out= value cannot be empty');
+          process.exit(1);
+        }
+        const resolvedOut = path.resolve(process.cwd(), rawOut);
+        const cwd = path.resolve(process.cwd());
+        const rel = path.relative(cwd, resolvedOut);
+        // Reject paths that escape the current working directory or are
+        // absolute on a different volume/root. This prevents --out=../../etc
+        // from writing outside the project tree.
+        if (rel.startsWith('..') || path.isAbsolute(rel)) {
+          console.error('[fetch] --out= must resolve to a path inside the current working directory');
+          console.error('  Provided:  ' + rawOut);
+          console.error('  Resolved:  ' + resolvedOut);
+          console.error('  Workdir:   ' + cwd);
+          process.exit(1);
+        }
+        outDir = resolvedOut;
+      } else {
+        outDir = path.join('.', 'skills', safeId);
+      }
 
       if (!fs.existsSync(outDir)) fs.mkdirSync(outDir, { recursive: true });
 
@@ -913,7 +946,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.2",
+  "version": "1.69.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": {