@evomap/evolver 1.89.0 → 1.89.2

package/CONTRIBUTING.md

@@ -0,0 +1,19 @@
+## Contributing
+
+Thank you for contributing. Please follow these rules:
+
+- Do not use emoji (except the DNA emoji in documentation if needed).
+- Keep changes small and reviewable.
+- Update related documentation when you change behavior.
+- Run `node index.js` for a quick sanity check.
+
+Submit PRs with clear intent and scope.
+
+### Engineering conventions
+
+- **Spawn child CLIs as `node <entry.js>` — never via a `.cmd` shim, npm symlink, or bare command name.** When launching a harness/tool subprocess (claude-code, openclaw, codex, ...), resolve the JS entry behind the launcher and hand it to `node` directly. Two reasons:
+  1. On Windows, `child_process.spawn` without `shell:true` on a `.cmd`/`.bat` throws `EINVAL` since the CVE-2024-27980 fix (Node >=18.20.2 / 20.12.2 / 21.7.3) — this silently broke the auto-exec bridge on Windows.
+  2. Across platforms, shims/wrappers can emit warnings or silently exit on some machines. `node <entry>` is zero-shell, deterministic, and passes args via argv (no shell-injection surface).
+
+  `runChild` in `src/gep/execBridge.js` implements this for Windows npm shims (`_resolveNpmCmdShim`: parse the shim's `"%dp0%\<entry>" %*` exec line and rewrite `(bin, args)` -> `(process.execPath, [<entry>, ...args])`), falling back to the original target when it is not a recognized npm shim. POSIX binaries / wrappers spawn natively and are left unchanged. A unit test (`test/execBridgeSpawnNpmShim.test.js`) enforces the parser.
+

package/README.ja-JP.md

@@ -181,7 +181,7 @@ evolver --loop
 | ループ (`evolver --loop`) | 適応的スリープ付きのデーモンループで上記を繰り返す |
 | OpenClaw 内 | ホストランタイムが `sessions_spawn(...)` などの stdout ディレクティブを解釈 |
 
-> **`--loop` は「動作中のエージェントをリアルタイムで支援する」モードではありません。** ループモードはバックグラウンドの自己メンテナンス（validator 実行、worker タスク、ATP マーチャント自動配信、solidify）のためのもので、その stdout は evolver 自身が消費します。したがって、たとえ OpenClaw / Cursor / Claude Code がインストールされていても、ループモードで出力される `sessions_spawn(...)` ディレクティブはこれらのホストには届きません。evolver にライブセッションを観察・補助させたい場合は、そのエージェントセッションの **内部から** `evolver run` を呼び出してください（OpenClaw はその単一ランの stdout ディレクティブを取り込みます）。OpenClaw ユーザーはさらに、`AGENT_NAME`（または `AGENT_SESSIONS_DIR`）が実際にセッションを生成しているエージェントのディレクトリ（`~/.openclaw/agents/<名前>/sessions/`）を指していることを確認してください -- さもないと evolver は自身のログにフォールバックし、「空転している」ように見えます。
+> **`--loop` は「動作中のエージェントをリアルタイムで支援する」モードではありません。** ループモードはバックグラウンドの自己メンテナンス（validator 実行、worker タスク、ATP マーチャント自動配信、solidify）のためのもので、その stdout は evolver 自身が消費します。したがって、たとえ OpenClaw / Cursor / Claude Code がインストールされていても、ループモードで出力される `sessions_spawn(...)` ディレクティブはこれらのホストには届きません。evolver にライブセッションを観察・補助させたい場合は、そのエージェントセッションの **内部から** `evolver` を呼び出してください（OpenClaw はその単一ランの stdout ディレクティブを取り込みます）。OpenClaw ユーザーはさらに、`AGENT_NAME`（または `AGENT_SESSIONS_DIR`）が実際にセッションを生成しているエージェントのディレクトリ（`~/.openclaw/agents/<名前>/sessions/`）を指していることを確認してください -- さもないと evolver は自身のログにフォールバックし、「空転している」ように見えます。
 
 ## 対象ユーザー
 
@@ -404,7 +404,7 @@ EVOLVE_REPORT_TOOL=feishu-card
 永続的にオプトアウト：
 
 ```bash
-EVOLVER_VALIDATOR_ENABLED=0 evolver run --loop
+EVOLVER_VALIDATOR_ENABLED=0 evolver --loop
 ```
 
 ### GitHub Issue 自動報告
@@ -414,7 +414,7 @@ evolver が持続的な失敗（失敗ループまたは高い失敗率での繰
 | 変数 | デフォルト | 説明 |
 |----------|---------|-------------|
 | `EVOLVER_AUTO_ISSUE` | `true` | 自動 issue 報告の有効/無効 |
-| `EVOLVER_ISSUE_REPO` | `autogame-17/capability-evolver` | ターゲット GitHub リポジトリ (owner/repo) |
+| `EVOLVER_ISSUE_REPO` | `EvoMap/evolver` | ターゲット GitHub リポジトリ (owner/repo) |
 | `EVOLVER_ISSUE_COOLDOWN_MS` | `86400000` (24h) | 同じエラーシグネチャのクールダウン期間 |
 | `EVOLVER_ISSUE_MIN_STREAK` | `5` | トリガーする最小連続失敗ストリーク |
 
@@ -456,33 +456,6 @@ evolver が持続的な失敗（失敗ループまたは高い失敗率での繰
 
 `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
@@ -517,8 +490,12 @@ MAJOR.MINOR.PATCH
 
 ## ロードマップ
 
-- 1 分間のデモワークフローを追加
-- 代替案との比較表を追加
+方針であり確約ではありません。最新のバックログは [GitHub Issues](https://github.com/EvoMap/evolver/issues) を参照してください。
+
+- **オンボーディング**: 1 分間のクイックスタートデモと、他のエージェント進化手法との比較表。
+- **GEP 統合の深化**: より豊富なシグナル抽出と Gene / Capsule 選択、および再利用アナリティクス。
+- **メモリとスキル**: セッション結果を再利用可能な Gene / Capsule へより速く蒸留。
+- **対応ランタイムの拡大**: Cursor / Claude Code / Codex / Kiro / opencode / OpenClaw 以外のホスト統合を拡充。
 
 ## Star 履歴
 

package/README.ko-KR.md

@@ -180,7 +180,7 @@ evolver --loop
 | 루프 (`evolver --loop`) | 적응형 슬립이 포함된 데몬 루프에서 위 과정을 반복 |
 | OpenClaw 내부 | 호스트 런타임이 `sessions_spawn(...)` 등 stdout 지시문을 해석 |
 
-> **`--loop`은 "실행 중인 에이전트를 실시간으로 보조하는" 모드가 아닙니다.** 루프 모드는 백그라운드 자가 유지보수(validator 실행, worker 작업, ATP 상인 자동 배달, solidify)를 위한 것이며, 그 stdout은 evolver 자신이 소비합니다. 따라서 OpenClaw / Cursor / Claude Code가 설치되어 있더라도, 루프 모드에서 출력되는 `sessions_spawn(...)` 지시문은 이 호스트들에 전달되지 않습니다. 라이브 세션을 evolver가 관찰·보조하게 하려면, 해당 에이전트 세션 **내부에서** `evolver run`을 호출하세요(OpenClaw는 그 단일 실행의 stdout 지시문을 처리합니다). OpenClaw 사용자는 추가로, `AGENT_NAME`(또는 `AGENT_SESSIONS_DIR`)이 실제로 세션을 생성하는 에이전트 디렉터리(`~/.openclaw/agents/<이름>/sessions/`)를 가리키는지 확인하세요 -- 그렇지 않으면 evolver는 자신의 로그로 폴백하며, "빈 사이클만 돌고 있는" 것처럼 보입니다.
+> **`--loop`은 "실행 중인 에이전트를 실시간으로 보조하는" 모드가 아닙니다.** 루프 모드는 백그라운드 자가 유지보수(validator 실행, worker 작업, ATP 상인 자동 배달, solidify)를 위한 것이며, 그 stdout은 evolver 자신이 소비합니다. 따라서 OpenClaw / Cursor / Claude Code가 설치되어 있더라도, 루프 모드에서 출력되는 `sessions_spawn(...)` 지시문은 이 호스트들에 전달되지 않습니다. 라이브 세션을 evolver가 관찰·보조하게 하려면, 해당 에이전트 세션 **내부에서** `evolver`을 호출하세요(OpenClaw는 그 단일 실행의 stdout 지시문을 처리합니다). OpenClaw 사용자는 추가로, `AGENT_NAME`(또는 `AGENT_SESSIONS_DIR`)이 실제로 세션을 생성하는 에이전트 디렉터리(`~/.openclaw/agents/<이름>/sessions/`)를 가리키는지 확인하세요 -- 그렇지 않으면 evolver는 자신의 로그로 폴백하며, "빈 사이클만 돌고 있는" 것처럼 보입니다.
 
 ## 대상 사용자
 
@@ -403,7 +403,7 @@ EVOLVE_REPORT_TOOL=feishu-card
 영구적으로 옵트아웃:
 
 ```bash
-EVOLVER_VALIDATOR_ENABLED=0 evolver run --loop
+EVOLVER_VALIDATOR_ENABLED=0 evolver --loop
 ```
 
 ### 자동 GitHub Issue 보고
@@ -413,7 +413,7 @@ evolver가 지속적인 실패(실패 루프 또는 높은 실패율의 반복
 | 변수 | 기본값 | 설명 |
 |------|--------|------|
 | `EVOLVER_AUTO_ISSUE` | `true` | 자동 issue 보고 활성화/비활성화 |
-| `EVOLVER_ISSUE_REPO` | `autogame-17/capability-evolver` | 대상 GitHub 저장소 (owner/repo) |
+| `EVOLVER_ISSUE_REPO` | `EvoMap/evolver` | 대상 GitHub 저장소 (owner/repo) |
 | `EVOLVER_ISSUE_COOLDOWN_MS` | `86400000` (24시간) | 동일 오류 시그니처의 쿨다운 기간 |
 | `EVOLVER_ISSUE_MIN_STREAK` | `5` | 보고를 트리거하는 최소 연속 실패 횟수 |
 
@@ -455,33 +455,6 @@ evolver가 지속적인 실패(실패 루프 또는 높은 실패율의 반복
 
 `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` (`true`로 설정하면 GitHub Release 생성을 건너뜀; 기본값은 생성)
-- `RELEASE_USE_GH` (`true`로 설정하면 GitHub API 대신 `gh` CLI 사용)
-- `PUBLIC_RELEASE_ONLY` (`true`로 설정하면 기존 태그에 대해 Release만 생성; 코드 게시 없음)
-
 ## 버전 관리 (SemVer)
 
 MAJOR.MINOR.PATCH
@@ -516,8 +489,12 @@ MAJOR.MINOR.PATCH
 
 ## 로드맵
 
-- 1분 데모 워크플로 추가
-- 대안과의 비교 표 추가
+방향성이며 확약은 아닙니다. 최신 백로그는 [GitHub Issues](https://github.com/EvoMap/evolver/issues)에서 확인하세요.
+
+- **온보딩**: 1분 퀵스타트 데모와 대안 에이전트 진화 방식과의 비교 표.
+- **GEP 통합 심화**: 더 풍부한 시그널 추출과 Gene / Capsule 선택, 그리고 재사용 분석.
+- **메모리와 스킬**: 세션 결과를 재사용 가능한 Gene / Capsule로 더 빠르게 증류.
+- **런타임 커버리지 확대**: Cursor / Claude Code / Codex / Kiro / opencode / OpenClaw 외 호스트 통합 확대.
 
 ## Star History