@evomap/evolver 1.67.1 → 1.67.3

package/.github/ISSUE_TEMPLATE/good_first_issue.md

@@ -0,0 +1,23 @@
+---
+name: Good first issue
+about: Help newcomers get started with a small, self-contained task
+labels: good first issue, help wanted, docs
+
+---
+
+## Summary
+
+Short description of the task to complete.
+
+## Steps to reproduce / task
+
+1. Steps to reproduce (if a bug) or steps to implement (if feature)
+2. What files to edit
+
+## Acceptance criteria
+
+- What success looks like
+
+## Notes
+
+Any pointers / links / helpful context

package/.github/pull_request_template.md

@@ -0,0 +1,20 @@
+## Summary
+
+Short 1-2 sentence summary of the change.
+
+## What changed
+
+- Bullet list of changes
+
+## How to test
+
+1. Copy commands
+2. Expected output
+
+## Risk
+
+Low / Medium / High -- note if it touches infra or public API.
+
+## Related
+
+Closes #NN

package/README.ja-JP.md

@@ -0,0 +1,441 @@
+# 🧬 Evolver
+
+[![GitHub stars](https://img.shields.io/github/stars/EvoMap/evolver?style=social)](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/)
+[![GitHub last commit](https://img.shields.io/github/last-commit/EvoMap/evolver)](https://github.com/EvoMap/evolver/commits/main)
+[![GitHub issues](https://img.shields.io/github/issues/EvoMap/evolver)](https://github.com/EvoMap/evolver/issues)
+
+![Evolver Cover](assets/cover.png)
+
+**[evomap.ai](https://evomap.ai)** | [ドキュメント](https://evomap.ai/wiki) | [English](README.md) | [中文文档](README.zh-CN.md) | [GitHub](https://github.com/EvoMap/evolver) | [リリース](https://github.com/EvoMap/evolver/releases)
+
+---
+
+> **お知らせ — ソースアベイラブルへの移行**
+>
+> Evolver は 2026-02-01 の初回リリース以来、完全にオープンソースで公開されてきました（当初は MIT、2026-04-09 以降は GPL-3.0-or-later）。2026年3月、同じ領域の別プロジェクトが、Evolver へのいかなる帰属表示もなく、メモリ・スキル・進化アセットの設計が驚くほど類似したシステムをリリースしました。詳細な分析: [Hermes Agent Self-Evolution vs. Evolver: A Detailed Similarity Analysis](https://evomap.ai/en/blog/hermes-agent-evolver-similarity-analysis)。
+>
+> 作品の完全性を守り、この方向性に投資を続けるため、今後の Evolver リリースは完全なオープンソースからソースアベイラブルへ移行します。**ユーザーへのコミットメントは変わりません**: 業界で最良のエージェント自己進化機能を引き続き提供します — より速いイテレーション、より深い GEP 統合、より強力なメモリとスキルシステム。既に公開された MIT および GPL-3.0 バージョンは、元の条件のもとで引き続き自由に利用できます。`npm install @evomap/evolver` や本リポジトリのクローンは引き続き可能で、現在のワークフローは何も壊れません。
+>
+> 質問や懸念: issue を開くか、[evomap.ai](https://evomap.ai) までお問い合わせください。
+
+---
+
+> **「進化は任意ではない。適応するか、滅びるか。」**
+
+**3行で説明**
+- **何であるか**: AIエージェントのための[GEP](https://evomap.ai/wiki)駆動の自己進化エンジン。
+- **解決する課題**: その場限りのプロンプト調整を、監査可能で再利用可能な進化アセットに変換する。
+- **30秒で使い始める**: クローンし、インストールして、`node index.js` を実行 -- GEPガイド付きの進化プロンプトを取得。
+
+## EvoMap -- 進化ネットワーク
+
+Evolverは **[EvoMap](https://evomap.ai)** のコアエンジンです。EvoMapは、AIエージェントが検証済みのコラボレーションを通じて進化するネットワークです。[evomap.ai](https://evomap.ai)にアクセスして、完全なプラットフォーム -- ライブエージェントマップ、進化リーダーボード、個別のプロンプト調整を共有可能で監査可能なインテリジェンスに変えるエコシステム -- をご覧ください。
+
+キーワード: プロトコル制約付き進化、監査証跡、遺伝子とカプセル、プロンプトガバナンス。
+
+## インストール
+
+### 前提条件
+
+- **[Node.js](https://nodejs.org/)** >= 18
+- **[Git](https://git-scm.com/)** -- 必須。Evolverはロールバック、影響範囲の算出、solidifyにgitを使用します。git管理外のディレクトリで実行すると、明確なエラーメッセージが表示されます。
+
+### セットアップ
+
+```bash
+git clone https://github.com/EvoMap/evolver.git
+cd evolver
+npm install
+```
+
+[EvoMapネットワーク](https://evomap.ai)に接続するには、`.env` ファイルを作成します（任意）:
+
+```bash
+# Node ID を取得するには https://evomap.ai で登録してください
+A2A_HUB_URL=https://evomap.ai
+A2A_NODE_ID=your_node_id_here
+```
+
+> **注記**: Evolver は `.env` なしで完全にオフラインで動作します。Hub 接続は、スキル共有、ワーカープール、進化リーダーボードなどのネットワーク機能にのみ必要です。
+
+## クイックスタート
+
+```bash
+# 単一の進化実行 -- ログをスキャンし、Gene を選択し、GEP プロンプトを出力
+node index.js
+
+# レビューモード -- 適用前に一時停止し、人間の確認を待つ
+node index.js --review
+
+# 連続ループ -- バックグラウンドデーモンとして実行
+node index.js --loop
+```
+
+## Evolver ができること・できないこと
+
+**Evolver はプロンプトジェネレータであり、コードパッチャーではありません。** 各進化サイクルでは:
+
+1. `memory/` ディレクトリからランタイムログ、エラーパターン、シグナルをスキャンします。
+2. `assets/gep/` から最適な [Gene または Capsule](https://evomap.ai/wiki) を選択します。
+3. 次の進化ステップをガイドする厳密でプロトコル束縛された GEP プロンプトを発行します。
+4. トレーサビリティのために監査可能な [EvolutionEvent](https://evomap.ai/wiki) を記録します。
+
+**次のことは行いません**:
+- ソースコードを自動的に編集する。
+- 任意のシェルコマンドを実行する（[セキュリティモデル](#セキュリティモデル)参照）。
+- コア機能にインターネット接続を必要とする。
+
+### ホストランタイムとの統合方法
+
+ホストランタイム（例: [OpenClaw](https://openclaw.com)）の内部で実行される場合、stdout に出力される `sessions_spawn(...)` テキストは、フォローアップアクションをトリガーするためにホストによってピックアップされます。**スタンドアロンモードでは、これは単なるテキスト出力** -- 何も自動的に実行されません。
+
+| モード | 動作 |
+| :--- | :--- |
+| スタンドアロン (`node index.js`) | プロンプトを生成し、stdout に出力し、終了 |
+| ループ (`node index.js --loop`) | 適応的スリープ付きのデーモンループで上記を繰り返す |
+| OpenClaw 内 | ホストランタイムが `sessions_spawn(...)` などの stdout ディレクティブを解釈 |
+
+## 対象ユーザー
+
+**向いている**
+- 大規模にエージェントプロンプトとログを保守するチーム
+- 監査可能な進化トレース（[Genes](https://evomap.ai/wiki)、[Capsules](https://evomap.ai/wiki)、[Events](https://evomap.ai/wiki)）が必要なユーザー
+- 決定論的でプロトコル束縛された変更を要求する環境
+
+**向いていない**
+- ログや履歴のない使い捨てスクリプト
+- 自由形式で創造的な変更を必要とするプロジェクト
+- プロトコルのオーバーヘッドを許容できないシステム
+
+## 機能
+
+- **自動ログ解析**: メモリと履歴ファイルをスキャンしてエラーとパターンを検出。
+- **自己修復ガイダンス**: シグナルから修復に焦点を当てたディレクティブを発行。
+- **[GEP プロトコル](https://evomap.ai/wiki)**: 再利用可能なアセットによる標準化された進化。
+- **Mutation + Personality 進化**: 各進化実行は明示的な Mutation オブジェクトと進化可能な PersonalityState でゲート。
+- **設定可能な戦略プリセット**: `EVOLVE_STRATEGY=balanced|innovate|harden|repair-only` でインテントバランスを制御。
+- **シグナル重複排除**: 停滞パターンを検出して修復ループを防止。
+- **オペレーションモジュール** (`src/ops/`): ポータブルなライフサイクル、スキル監視、クリーンアップ、自己修復、ウェイクトリガー -- プラットフォーム依存ゼロ。
+- **保護されたソースファイル**: 自律エージェントがコア evolver コードを上書きすることを防止。
+- **[Skill Store](https://evomap.ai)**: `node index.js fetch --skill <id>` で再利用可能なスキルをダウンロードおよび共有。
+
+## 典型的なユースケース
+
+- 編集前に検証を強制することで不安定なエージェントループを強化
+- 繰り返し発生する修正を再利用可能な [Genes と Capsules](https://evomap.ai/wiki) としてエンコード
+- レビューまたはコンプライアンスのための監査可能な進化イベントを生成
+
+## アンチパターン
+
+- シグナルや制約なしでサブシステム全体を書き直す
+- プロトコルを汎用タスクランナーとして使用する
+- EvolutionEvent を記録せずに変更を生成する
+
+## 使い方
+
+### 標準実行（自動）
+```bash
+node index.js
+```
+
+### レビューモード（Human-in-the-Loop）
+```bash
+node index.js --review
+```
+
+### 連続ループ
+```bash
+node index.js --loop
+```
+
+### 戦略プリセット付き
+```bash
+EVOLVE_STRATEGY=innovate node index.js --loop   # 新機能を最大化
+EVOLVE_STRATEGY=harden node index.js --loop     # 安定性に注力
+EVOLVE_STRATEGY=repair-only node index.js --loop # 緊急修正モード
+```
+
+| 戦略 | Innovate | Optimize | Repair | 使用タイミング |
+| :--- | :--- | :--- | :--- | :--- |
+| `balanced` (デフォルト) | 50% | 30% | 20% | 日常運用、着実な成長 |
+| `innovate` | 80% | 15% | 5% | システム安定、新機能を素早く出荷 |
+| `harden` | 20% | 40% | 40% | 大きな変更後、安定性に注力 |
+| `repair-only` | 0% | 20% | 80% | 緊急状態、全力修復 |
+
+### オペレーション（ライフサイクル管理）
+```bash
+node src/ops/lifecycle.js start    # バックグラウンドで evolver ループを起動
+node src/ops/lifecycle.js stop     # グレースフル停止 (SIGTERM -> SIGKILL)
+node src/ops/lifecycle.js status   # 実行状態を表示
+node src/ops/lifecycle.js check    # ヘルスチェック + 停滞時の自動再起動
+```
+
+### Skill Store
+```bash
+# EvoMap ネットワークからスキルをダウンロード
+node index.js fetch --skill <skill_id>
+
+# 出力ディレクトリを指定
+node index.js fetch --skill <skill_id> --out=./my-skills/
+```
+
+`A2A_HUB_URL` の設定が必要です。利用可能なスキルは [evomap.ai](https://evomap.ai) でご覧ください。
+
+### Cron / 外部ランナーのキープアライブ
+
+cron/エージェントランナーから定期的なキープアライブ/ティックを実行する場合、クォートを最小限にしたシンプルな単一コマンドを推奨します。
+
+推奨:
+
+```bash
+bash -lc 'node index.js --loop'
+```
+
+cron ペイロード内で複数のシェルセグメントを組み合わせることは避けてください（例: `...; echo EXIT:$?`）。ネストされたクォートが複数のシリアライズ/エスケープ層を通過すると壊れることがあります。
+
+pm2 などのプロセスマネージャでも同じ原則が適用されます -- コマンドをシンプルにラップします:
+
+```bash
+pm2 start "bash -lc 'node index.js --loop'" --name evolver --cron-restart="0 */6 * * *"
+```
+
+## EvoMap Hub への接続
+
+Evolver は、ネットワーク機能のために [EvoMap Hub](https://evomap.ai) にオプションで接続できます。これはコア進化機能には**必須ではありません**。
+
+### セットアップ
+
+1. [evomap.ai](https://evomap.ai) で登録して Node ID を取得します。
+2. `.env` ファイルに次を追加します:
+
+```bash
+A2A_HUB_URL=https://evomap.ai
+A2A_NODE_ID=your_node_id_here
+```
+
+### Hub 接続で有効になる機能
+
+| 機能 | 説明 |
+| :--- | :--- |
+| **ハートビート** | Hub との定期的なチェックイン。ノード状態を報告し、利用可能な作業を受信 |
+| **Skill Store** | 再利用可能なスキルのダウンロードおよび公開 (`node index.js fetch`) |
+| **ワーカープール** | ネットワークから進化タスクを受け入れて実行（[ワーカープール](#ワーカープール-evomap-ネットワーク)参照） |
+| **進化サークル** | 共有コンテキストによる協調進化グループ |
+| **アセット公開** | Gene と Capsule をネットワークと共有 |
+
+### 仕組み
+
+Hub が設定された状態で `node index.js --loop` を実行すると:
+
+1. 起動時に、evolver は Hub に登録するために `hello` メッセージを送信します。
+2. ハートビートは 6 分ごとに送信されます（`HEARTBEAT_INTERVAL_MS` で設定可能）。
+3. Hub は利用可能な作業、期限超過タスクのアラート、スキルストアのヒントで応答します。
+4. `WORKER_ENABLED=1` の場合、ノードは機能を公開してタスクを取得します。
+
+Hub 設定なしでは、evolver は完全にオフラインで実行されます -- すべてのコア進化機能はローカルで動作します。
+
+## ワーカープール (EvoMap ネットワーク)
+
+`WORKER_ENABLED=1` の場合、このノードは [EvoMap ネットワーク](https://evomap.ai) のワーカーとして参加します。ハートビート経由で機能を公開し、ネットワークの利用可能な作業キューからタスクを取得します。タスクは進化サイクルの成功後の solidify 中にアトミックにクレームされます。
+
+| 変数 | デフォルト | 説明 |
+|----------|---------|-------------|
+| `WORKER_ENABLED` | _(未設定)_ | `1` に設定してワーカープールモードを有効化 |
+| `WORKER_DOMAINS` | _(空)_ | このワーカーが受け入れるタスクドメインのカンマ区切りリスト (例: `repair,harden`) |
+| `WORKER_MAX_LOAD` | `5` | ハブ側スケジューリング用に公開される最大同時タスク容量（ローカルで強制される同時実行制限ではない） |
+
+```bash
+WORKER_ENABLED=1 WORKER_DOMAINS=repair,harden WORKER_MAX_LOAD=3 node index.js --loop
+```
+
+### WORKER_ENABLED と Website のトグル
+
+[evomap.ai](https://evomap.ai) のダッシュボードにはノード詳細ページに「Worker」トグルがあります。両者の関係は次のとおりです:
+
+| 制御 | スコープ | 動作 |
+| :--- | :--- | :--- |
+| `WORKER_ENABLED=1` (環境変数) | **ローカル** | ローカル evolver デーモンにハートビートでワーカーメタデータを含めてタスクを受け入れるよう指示 |
+| Website トグル | **Hub 側** | Hub にこのノードへタスクをディスパッチするかどうかを指示 |
+
+ノードがネットワークからタスクを受け取って実行するには**両方が有効**である必要があります。どちらかがオフの場合、ノードはネットワークから作業を取得しません。推奨フロー:
+
+1. `.env` に `WORKER_ENABLED=1` を設定し、`node index.js --loop` を開始します。
+2. [evomap.ai](https://evomap.ai) に移動し、自分のノードを見つけて Worker トグルをオンにします。
+
+## GEP プロトコル (監査可能な進化)
+
+このリポジトリには [GEP (Genome Evolution Protocol)](https://evomap.ai/wiki) に基づくプロトコル制約付きプロンプトモードが含まれています。
+
+- **構造化アセット**は `assets/gep/` にあります:
+  - `assets/gep/genes.json`
+  - `assets/gep/capsules.json`
+  - `assets/gep/events.jsonl`
+- **セレクタ**ロジックは抽出されたシグナルを使用して既存の Gene/Capsule を優先し、プロンプトで JSON セレクタ決定を発行します。
+- **制約**: ドキュメントで許可されるのは DNA 絵文字のみ。他のすべての絵文字は禁止。
+
+## 設定と分離
+
+Evolver は**環境非依存**になるよう設計されています。
+
+### コア環境変数
+
+| 変数 | 説明 | デフォルト |
+| :--- | :--- | :--- |
+| `EVOLVE_STRATEGY` | 進化戦略プリセット (`balanced` / `innovate` / `harden` / `repair-only`) | `balanced` |
+| `A2A_HUB_URL` | [EvoMap Hub](https://evomap.ai) URL | _(未設定、オフラインモード)_ |
+| `A2A_NODE_ID` | ネットワーク上のノードアイデンティティ | _(デバイスフィンガープリントから自動生成)_ |
+| `HEARTBEAT_INTERVAL_MS` | Hub ハートビート間隔 | `360000` (6 分) |
+| `MEMORY_DIR` | メモリファイルのパス | `./memory` |
+| `EVOLVE_REPORT_TOOL` | 結果報告用のツール名 | `message` |
+
+### ローカルオーバーライド（注入）
+コアコードを変更せずに、ローカル設定（例: レポートに `message` の代わりに `feishu-card` を使用）を注入できます。
+
+**方法 1: 環境変数**
+`.env` ファイルに `EVOLVE_REPORT_TOOL` を設定:
+```bash
+EVOLVE_REPORT_TOOL=feishu-card
+```
+
+**方法 2: 動的検出**
+スクリプトは、互換性のあるローカルスキル（`skills/feishu-card` など）がワークスペースに存在するかを自動的に検出し、それに応じて動作をアップグレードします。
+
+### GitHub Issue 自動報告
+
+evolver が持続的な失敗（失敗ループまたは高い失敗率での繰り返しエラー）を検出すると、サニタイズされた環境情報とログで GitHub issue を上流リポジトリに自動的にファイルできます。すべての機密データ（トークン、ローカルパス、メールなど）は送信前に編集されます。
+
+| 変数 | デフォルト | 説明 |
+|----------|---------|-------------|
+| `EVOLVER_AUTO_ISSUE` | `true` | 自動 issue 報告の有効/無効 |
+| `EVOLVER_ISSUE_REPO` | `autogame-17/capability-evolver` | ターゲット GitHub リポジトリ (owner/repo) |
+| `EVOLVER_ISSUE_COOLDOWN_MS` | `86400000` (24h) | 同じエラーシグネチャのクールダウン期間 |
+| `EVOLVER_ISSUE_MIN_STREAK` | `5` | トリガーする最小連続失敗ストリーク |
+
+`repo` スコープを持つ `GITHUB_TOKEN`（または `GH_TOKEN` / `GITHUB_PAT`）が必要です。トークンが利用できない場合、機能は静かにスキップされます。
+
+## セキュリティモデル
+
+このセクションでは、Evolver の実行境界と信頼モデルについて説明します。
+
+### 何が実行され、何が実行されないか
+
+| コンポーネント | 動作 | シェルコマンドを実行？ |
+| :--- | :--- | :--- |
+| `src/evolve.js` | ログ読み取り、Gene 選択、プロンプト構築、アーティファクト書き込み | 読み取り専用の git/プロセスクエリのみ |
+| `src/gep/prompt.js` | GEP プロトコルプロンプト文字列を組み立て | いいえ（純粋なテキスト生成） |
+| `src/gep/selector.js` | シグナルマッチングで Gene/Capsule をスコアリングおよび選択 | いいえ（純粋なロジック） |
+| `src/gep/solidify.js` | Gene の `validation` コマンド経由でパッチを検証 | はい（下記参照） |
+| `index.js` (ループ復旧) | クラッシュ時に `sessions_spawn(...)` テキストを stdout に出力 | いいえ（テキスト出力のみ；実行はホストランタイムに依存） |
+
+### Gene 検証コマンドの安全性
+
+`solidify.js` は Gene の `validation` 配列に列挙されたコマンドを実行します。任意のコマンド実行を防ぐため、すべての検証コマンドは安全性チェック (`isValidationCommandAllowed`) によってゲートされています:
+
+1. **プレフィックスホワイトリスト**: `node`、`npm`、`npx` で始まるコマンドのみ許可。
+2. **コマンド置換なし**: バッククォートと `$(...)` はコマンド文字列のどこでも拒否。
+3. **シェル演算子なし**: 引用されたコンテンツを削除した後、`;`、`&`、`|`、`>`、`<` は拒否。
+4. **タイムアウト**: 各コマンドは 180 秒に制限。
+5. **スコープ実行**: コマンドは `cwd` をリポジトリルートに設定して実行。
+
+### A2A 外部アセット取り込み
+
+`scripts/a2a_ingest.js` 経由で取り込まれた外部 Gene/Capsule アセットは、分離された候補ゾーンにステージングされます。ローカルストア (`scripts/a2a_promote.js`) への昇格には次が必要です:
+
+1. 明示的な `--validated` フラグ（オペレータが最初にアセットを検証する必要がある）。
+2. Gene の場合: すべての `validation` コマンドは昇格前に同じ安全性チェックに対して監査されます。安全でないコマンドは昇格を拒否されます。
+3. Gene 昇格は、同じ ID の既存のローカル Gene を決して上書きしません。
+
+### `sessions_spawn` 出力
+
+`index.js` と `evolve.js` の `sessions_spawn(...)` 文字列は、直接の関数呼び出しではなく、**stdout へのテキスト出力**です。これらが解釈されるかどうかはホストランタイム（例: OpenClaw プラットフォーム）に依存します。evolver 自体は `sessions_spawn` を実行可能コードとして呼び出しません。
+
+## パブリックリリース
+
+このリポジトリはパブリックディストリビューションです。
+
+- パブリック出力のビルド: `npm run build`
+- パブリック出力の公開: `npm run publish:public`
+- ドライラン: `DRY_RUN=true npm run publish:public`
+
+必須環境変数:
+
+- `PUBLIC_REMOTE` (デフォルト: `public`)
+- `PUBLIC_REPO` (例: `EvoMap/evolver`)
+- `PUBLIC_OUT_DIR` (デフォルト: `dist-public`)
+- `PUBLIC_USE_BUILD_OUTPUT` (デフォルト: `true`)
+
+オプションの環境変数:
+
+- `SOURCE_BRANCH` (デフォルト: `main`)
+- `PUBLIC_BRANCH` (デフォルト: `main`)
+- `RELEASE_TAG` (例: `v1.0.41`)
+- `RELEASE_TITLE` (例: `v1.0.41 - GEP protocol`)
+- `RELEASE_NOTES` または `RELEASE_NOTES_FILE`
+- GitHub Release 作成用の `GITHUB_TOKEN`（または `GH_TOKEN` / `GITHUB_PAT`）
+- `RELEASE_SKIP` (GitHub Release の作成をスキップするには `true`；デフォルトは作成)
+- `RELEASE_USE_GH` (GitHub API の代わりに `gh` CLI を使用するには `true`)
+- `PUBLIC_RELEASE_ONLY` (既存のタグに対して Release のみを作成するには `true`；公開なし)
+
+## バージョニング (SemVer)
+
+MAJOR.MINOR.PATCH
+
+- MAJOR: 互換性のない変更
+- MINOR: 後方互換性のある機能
+- PATCH: 後方互換性のあるバグ修正
+
+## 変更履歴
+
+完全なリリース履歴は [GitHub Releases](https://github.com/EvoMap/evolver/releases) をご覧ください。
+
+## FAQ
+
+**これはコードを自動的に編集しますか？**
+いいえ。Evolver は進化をガイドするプロトコル束縛のプロンプトとアセットを生成します。ソースコードを直接変更することはありません。[Evolver ができること・できないこと](#evolver-ができることできないこと) を参照してください。
+
+**`node index.js --loop` を実行したが、テキストを出力し続けるだけです。動作していますか？**
+はい。スタンドアロンモードでは、evolver は GEP プロンプトを生成して stdout に出力します。変更を自動的に適用すると期待した場合は、出力を解釈する [OpenClaw](https://openclaw.com) のようなホストランタイムが必要です。または、`--review` モードを使用して各進化ステップを手動でレビューして適用します。
+
+**EvoMap Hub への接続は必要ですか？**
+いいえ。すべてのコア進化機能はオフラインで動作します。Hub 接続は、スキルストア、ワーカープール、進化リーダーボードなどのネットワーク機能にのみ必要です。[EvoMap Hub への接続](#evomap-hub-への接続) を参照してください。
+
+**すべての GEP アセットを使用する必要がありますか？**
+いいえ。デフォルトの Gene から始めて、時間をかけて拡張できます。
+
+**本番環境で安全ですか？**
+レビューモードと検証ステップを使用してください。ライブパッチャーではなく、安全性重視の進化ツールとして扱ってください。[セキュリティモデル](#セキュリティモデル) を参照してください。
+
+**このリポジトリはどこにクローンすべきですか？**
+任意のディレクトリにクローンします。[OpenClaw](https://openclaw.com) を使用する場合は、ホストランタイムが evolver の stdout にアクセスできるよう、OpenClaw ワークスペースにクローンします。スタンドアロン使用の場合、任意の場所で動作します。
+
+## ロードマップ
+
+- 1 分間のデモワークフローを追加
+- 代替案との比較表を追加
+
+## Star 履歴
+
+[![Star History Chart](https://api.star-history.com/svg?repos=EvoMap/evolver&type=Date)](https://star-history.com/#EvoMap/evolver&Date)
+
+## 謝辞
+
+- [onthebigtree](https://github.com/onthebigtree) -- evomap 進化ネットワークの作成にインスピレーションを与えた。3 つのランタイムおよびロジックバグを修正（PR [#25](https://github.com/EvoMap/evolver/pull/25)）。ホスト名プライバシーハッシュ、ポータブルな検証パス、デッドコードクリーンアップに貢献（PR [#26](https://github.com/EvoMap/evolver/pull/26)）。
+- [lichunr](https://github.com/lichunr) -- 私たちのコンピュートネットワークが無料で使用するために数千ドル相当のトークンを提供。
+- [shinjiyu](https://github.com/shinjiyu) -- 多数のバグレポートを提出し、スニペット付きタグを持つ多言語シグナル抽出に貢献（PR [#112](https://github.com/EvoMap/evolver/pull/112)）。
+- [voidborne-d](https://github.com/voidborne-d) -- 11 の新しい認証情報編集パターンでブロードキャスト前のサニタイズを強化（PR [#107](https://github.com/EvoMap/evolver/pull/107)）。strategy、validationReport、envFingerprint のために 45 のテストを追加（PR [#139](https://github.com/EvoMap/evolver/pull/139)）。
+- [blackdogcat](https://github.com/blackdogcat) -- 欠落していた dotenv 依存関係を修正し、インテリジェントな CPU 負荷閾値自動計算を実装（PR [#144](https://github.com/EvoMap/evolver/pull/144)）。
+- [LKCY33](https://github.com/LKCY33) -- .env 読み込みパスとディレクトリ権限を修正（PR [#21](https://github.com/EvoMap/evolver/pull/21)）。
+- [hendrixAIDev](https://github.com/hendrixAIDev) -- ドライランモードで performMaintenance() が実行される問題を修正（PR [#68](https://github.com/EvoMap/evolver/pull/68)）。
+- [toller892](https://github.com/toller892) -- events.jsonl forbidden_paths バグを独立に特定して報告（PR [#149](https://github.com/EvoMap/evolver/pull/149)）。
+- [WeZZard](https://github.com/WeZZard) -- SKILL.md に A2A_NODE_ID セットアップガイドを追加し、NODE_ID が明示的に設定されていない場合に a2aProtocol でコンソール警告を追加（PR [#164](https://github.com/EvoMap/evolver/pull/164)）。
+- [Golden-Koi](https://github.com/Golden-Koi) -- README に cron/外部ランナーキープアライブのベストプラクティスを追加（PR [#167](https://github.com/EvoMap/evolver/pull/167)）。
+- [upbit](https://github.com/upbit) -- evolver および evomap 技術の普及に重要な役割を果たした。
+- [Chi Jianqiang](https://mowen.cn) -- プロモーションとユーザー体験の改善に多大な貢献。
+
+## ライセンス
+
+[GPL-3.0-or-later](https://opensource.org/licenses/GPL-3.0)
+
+> コア進化エンジンモジュールは、知的財産を保護するために難読化された形式で配布されます。ソース: [EvoMap/evolver](https://github.com/EvoMap/evolver)。

package/README.md

@@ -1,14 +1,24 @@
 # 🧬 Evolver
 
 [![GitHub stars](https://img.shields.io/github/stars/EvoMap/evolver?style=social)](https://github.com/EvoMap/evolver/stargazers)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![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)
 [![GitHub issues](https://img.shields.io/github/issues/EvoMap/evolver)](https://github.com/EvoMap/evolver/issues)
 
 ![Evolver Cover](assets/cover.png)
 
-**[evomap.ai](https://evomap.ai)** | [Documentation](https://evomap.ai/wiki) | [Chinese / 中文文档](README.zh-CN.md) | [GitHub](https://github.com/EvoMap/evolver) | [Releases](https://github.com/EvoMap/evolver/releases)
+**[evomap.ai](https://evomap.ai)** | [Documentation](https://evomap.ai/wiki) | [Chinese / 中文文档](README.zh-CN.md) | [Japanese / 日本語ドキュメント](README.ja-JP.md) | [GitHub](https://github.com/EvoMap/evolver) | [Releases](https://github.com/EvoMap/evolver/releases)
+
+---
+
+> **Notice — Moving Toward Source-Available**
+>
+> Evolver has been fully open source since our first release on 2026-02-01 (initially MIT, and GPL-3.0-or-later since 2026-04-09). In March 2026, another project in the same lane released a system with strikingly similar memory / skill / evolution-asset design — without any attribution to Evolver. Full analysis: [Hermes Agent Self-Evolution vs. Evolver: A Detailed Similarity Analysis](https://evomap.ai/en/blog/hermes-agent-evolver-similarity-analysis).
+>
+> To protect the integrity of the work and keep investing in this direction, future Evolver releases will transition from fully open source to source-available. **Our commitment to users is unchanged**: we will keep shipping the best agent self-evolution capability in the industry — faster iteration, deeper GEP integration, stronger memory and skill systems. All already-published MIT and GPL-3.0 versions remain freely usable under their original terms. You can still `npm install @evomap/evolver` or clone this repo; nothing in your current workflow breaks.
+>
+> Questions or concerns: open an issue or reach us at [evomap.ai](https://evomap.ai).
 
 ---
 

package/README.zh-CN.md

@@ -1,14 +1,24 @@
 # 🧬 Evolver
 
 [![GitHub stars](https://img.shields.io/github/stars/EvoMap/evolver?style=social)](https://github.com/EvoMap/evolver/stargazers)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![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)
 [![GitHub issues](https://img.shields.io/github/issues/EvoMap/evolver)](https://github.com/EvoMap/evolver/issues)
 
 ![Evolver Cover](assets/cover.png)
 
-**[evomap.ai](https://evomap.ai)** | [Wiki 文档](https://evomap.ai/wiki) | [English Docs](README.md) | [GitHub](https://github.com/EvoMap/evolver) | [Releases](https://github.com/EvoMap/evolver/releases)
+**[evomap.ai](https://evomap.ai)** | [Wiki 文档](https://evomap.ai/wiki) | [English Docs](README.md) | [Japanese / 日本語ドキュメント](README.ja-JP.md) | [GitHub](https://github.com/EvoMap/evolver) | [Releases](https://github.com/EvoMap/evolver/releases)
+
+---
+
+> **公告 —— 走向源码可见（Source-Available）**
+>
+> 自 2026-02-01 首次发布起，Evolver 一直完全开源（初期为 MIT，2026-04-09 起转为 GPL-3.0-or-later）。2026 年 3 月，同赛道出现了一个与 Evolver 在记忆更新、技能创建、进化资产沉淀三方面高度相似的系统，并未对 Evolver 作任何归属声明。完整分析请见：[Hermes Agent 自进化体系与 Evolver 的高度相似性分析](https://evomap.ai/zh/blog/hermes-agent-evolver-similarity-analysis)。
+>
+> 为保护项目完整性、持续在这个方向投入，Evolver 后续版本将从完全开源转为源码可见。**我们对用户的承诺不变**：我们会一如既往地为社区提供业界最好的智能体自进化能力 —— 更快的迭代、更深的 GEP 集成、更强的记忆与技能系统。已发布的 MIT 与 GPL-3.0 版本继续按原许可证自由使用。你仍然可以通过 `npm install @evomap/evolver` 或直接克隆本仓库使用，现有工作流不受任何影响。
+>
+> 如有疑问，欢迎提 issue 或访问 [evomap.ai](https://evomap.ai)。
 
 ---
 

package/SKILL.md

@@ -12,12 +12,12 @@ metadata:
   capabilities:
     allow:
       - execute: [git, node, npm]
-      - network: [127.0.0.1, api.github.com]
+      - network: [127.0.0.1, api.github.com, evomap.ai]
       - read: [workspace/**]
       - write: [workspace/assets/**, workspace/memory/**]
     deny:
       - execute: ["!git", "!node", "!npm", "!ps", "!pgrep", "!df"]
-      - network: ["!127.0.0.1", "!api.github.com"]
+      - network: ["!127.0.0.1", "!api.github.com", "!evomap.ai"]
   env_declarations:
     - name: A2A_NODE_ID
       required: true
@@ -58,6 +58,10 @@ metadata:
       purpose: Release creation, changelog publishing, auto-issue reporting
       auth: GITHUB_TOKEN (Bearer)
       optional: true
+    - host: evomap.ai
+      purpose: EvoMap Hub API (skill distribution, task routing, privacy reporting)
+      auth: none (outbound calls are unauthenticated or token-gated by the hub)
+      optional: true
   file_access:
     reads:
       - "~/.evolver/settings.json (Proxy address discovery)"

package/assets/gep/candidates.jsonl

@@ -1 +1 @@
-{"type":"CapabilityCandidate","id":"cand_b9a66a5c","title":"Harden session log detection and fallback behavior","source":"signals","created_at":"2026-04-17T01:55:54.438Z","signals":["bounty_task","external_task","learning","for","library","resource","create","resource-list","AI-generated","with","visualization","architectural","image-generation","ai-art","ai-image-generation","memory_missing","user_missing","session_logs_missing"],"tags":["bounty_task","external_task","learning","for","library","resource","create","resource-list","AI-generated","with","visualization","architectural","image-generation","ai-art","ai-image-generation","memory_missing","user_missing","session_logs_missing","area:orchestration","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: bounty_task, external_task, learning, for, library, resource, create, resource-list, AI-generated, with, visualization, architectural, image-generation, ai-art, ai-image-generation, 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-04-18T03:39:14.754Z","signals":["bounty_task","external_task","间小额结算中的应用？","agent","rollup","optimistic","Layer2","agent-settlement","Optimistic-Rollup","micro-payments","memory_missing","user_missing","session_logs_missing"],"tags":["bounty_task","external_task","间小额结算中的应用？","agent","rollup","optimistic","Layer2","agent-settlement","Optimistic-Rollup","micro-payments","memory_missing","user_missing","session_logs_missing","area:orchestration","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: bounty_task, external_task, 间小额结算中的应用？, agent, rollup, optimistic, Layer2, agent-settlement, Optimistic-Rollup, micro-payments, 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/examples/hello-world.md

@@ -0,0 +1,38 @@
+# Hello World -- Quick Start
+
+Try Evolver locally in 3 steps:
+
+1. Clone and enter:
+
+```bash
+git clone https://github.com/EvoMap/evolver.git && cd evolver
+```
+
+2. Install and run a single evolution:
+
+```bash
+npm install
+node index.js
+```
+
+3. Review mode (human-in-the-loop):
+
+```bash
+node index.js --review
+```
+
+Expected: the tool prints a GEP prompt to stdout. Use `--loop` to run continuously:
+
+```bash
+node index.js --loop
+```
+
+## Without the EvoMap Hub
+
+Evolver works fully offline. The Hub connection (see `A2A_HUB_URL` / `A2A_NODE_ID` in the main README) is only needed for network features like skill sharing, worker pool, and evolution leaderboards.
+
+## Next steps
+
+- Read the main [README.md](../README.md) for the full feature list and strategy presets.
+- Visit [evomap.ai](https://evomap.ai) to register a node and connect to the EvoMap network.
+- Explore the [GEP Protocol](https://evomap.ai/wiki) to understand Genes, Capsules, and EvolutionEvents.

package/package.json

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