From 0500674ef1cf418529bf6f9142a71b50247ab08f Mon Sep 17 00:00:00 2001 From: wanng-ide <1020181822@qq.com> Date: Mon, 16 Mar 2026 19:21:22 +0000 Subject: [PATCH] Release v2.0.0 Persist structured exploration context so wrapper and unified reports can render canonical role and target metadata without drift. Refresh release docs and upstream references for the 2.0.0 line. Made-with: Cursor --- CHANGELOG.md | 7 ++ README.md | 9 +- README.zh-CN.md | 2 +- index.js | 2 +- package.json | 2 +- src/evolve.js | 215 +++++++++++++++++++++++++++++++++++++-- src/gep/issueReporter.js | 2 +- 7 files changed, 226 insertions(+), 13 deletions(-) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..e5a1d46 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,7 @@ +# Changelog + +## 2.0.0 + +- Stabilized the runtime and solidify pipeline by tightening baseline tracking, runtime-only diff handling, and canonical status convergence. +- Added structured exploration context propagation so downstream reports can display exploration role, persona, target profile, and objective. +- Clarified the boundary between core evolver execution and wrapper/reporting layers for coordinated 2.x releases. diff --git a/README.md b/README.md index 66d396c..42595e9 100644 --- a/README.md +++ b/README.md @@ -34,6 +34,13 @@ node index.js The **Capability Evolver** inspects runtime history, extracts signals, selects a Gene/Capsule, and emits a strict GEP protocol prompt to guide safe evolution. +## What's New In 2.0.0 + +- **Stabilized runtime + solidify loop**: false-positive blast radius and empty-cycle failures were reduced by tightening baseline tracking and runtime-only diff handling. +- **Canonical reporting convergence**: wrapper summaries, status artifacts, and Unified Evolution Report now align on the same run outcome instead of drifting apart. +- **Structured exploration context**: exploration role/persona, target profile, and objective can now be carried as structured fields and surfaced in downstream reports. +- **Clearer core-wrapper boundary**: evolver is responsible for emitting structured exploration context, while wrappers focus on reporting and orchestration. + ## Who This Is For / Not For **For** @@ -244,7 +251,7 @@ When the evolver detects persistent failures (failure loop or recurring errors w | Variable | Default | Description | |----------|---------|-------------| | `EVOLVER_AUTO_ISSUE` | `true` | Enable/disable auto issue reporting | -| `EVOLVER_ISSUE_REPO` | `autogame-17/capability-evolver` | Target GitHub repository (owner/repo) | +| `EVOLVER_ISSUE_REPO` | `autogame-17/evolver` | Target GitHub repository (owner/repo) | | `EVOLVER_ISSUE_COOLDOWN_MS` | `86400000` (24h) | Cooldown period for the same error signature | | `EVOLVER_ISSUE_MIN_STREAK` | `5` | Minimum consecutive failure streak to trigger | diff --git a/README.zh-CN.md b/README.zh-CN.md index 30bac17..f42111d 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -207,7 +207,7 @@ MAJOR.MINOR.PATCH | 变量 | 默认值 | 说明 | |------|--------|------| | `EVOLVER_AUTO_ISSUE` | `true` | 是否启用自动 issue 上报 | -| `EVOLVER_ISSUE_REPO` | `autogame-17/capability-evolver` | 目标 GitHub 仓库（owner/repo） | +| `EVOLVER_ISSUE_REPO` | `autogame-17/evolver` | 目标 GitHub 仓库（owner/repo） | | `EVOLVER_ISSUE_COOLDOWN_MS` | `86400000`（24 小时） | 同类错误签名的冷却期 | | `EVOLVER_ISSUE_MIN_STREAK` | `5` | 触发上报所需的最低连续失败次数 | diff --git a/index.js b/index.js index e1bfa95..ff5dc8e 100644 --- a/index.js +++ b/index.js @@ -256,7 +256,7 @@ async function main() { // Post-run hint console.log('\n' + '======================================================='); console.log('Capability evolver finished. If you use this project, consider starring the upstream repository.'); - console.log('Upstream: https://github.com/autogame-17/capability-evolver'); + console.log('Upstream: https://github.com/autogame-17/evolver'); console.log('=======================================================\n'); } else if (command === 'solidify') { diff --git a/package.json b/package.json index a767c16..058cb4b 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@evomap/evolver", - "version": "1.31.0", + "version": "2.0.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": { diff --git a/src/evolve.js b/src/evolve.js index 5eadfa9..9d59f61 100644 --- a/src/evolve.js +++ b/src/evolve.js @@ -69,6 +69,185 @@ try { console.warn('[Evolver] Failed to create MEMORY_DIR (may cause downstream errors):', e && e.message || e); } +function readJsonIfExists(filePath, fallback) { + try { + if (!filePath || !fs.existsSync(filePath)) return fallback; + const raw = fs.readFileSync(filePath, 'utf8'); + if (!String(raw || '').trim()) return fallback; + return JSON.parse(raw); + } catch (_) { + return fallback; + } +} + +function writeJsonAtomic(filePath, value) { + if (!filePath) return; + const dirPath = path.dirname(filePath); + if (!fs.existsSync(dirPath)) fs.mkdirSync(dirPath, { recursive: true }); + const tmpPath = `${filePath}.tmp.${process.pid}`; + fs.writeFileSync(tmpPath, JSON.stringify(value, null, 2) + '\n', 'utf8'); + fs.renameSync(tmpPath, filePath); +} + +function firstNonEmptyValue(values) { + for (const value of Array.isArray(values) ? values : [values]) { + const text = String(value || '').replace(/\s+/g, ' ').trim(); + if (text) return text; + } + return ''; +} + +function clipInlineText(value, maxLen) { + const text = String(value || '').replace(/\s+/g, ' ').trim(); + if (!text) return ''; + const limit = Number.isFinite(Number(maxLen)) ? Number(maxLen) : 180; + return text.length <= limit ? text : `${text.slice(0, Math.max(0, limit - 3))}...`; +} + +function cleanPromptLine(value) { + return String(value || '') + .replace(/\*\*/g, '') + .replace(/`/g, '') + .replace(/\s+/g, ' ') + .trim(); +} + +function readFirstEnv(names, maxLen) { + for (const name of Array.isArray(names) ? names : [names]) { + const text = clipInlineText(process.env[name], maxLen); + if (text) return text; + } + return ''; +} + +function findPromptValue(promptText, patterns) { + const lines = String(promptText || '').split('\n'); + for (const rawLine of lines) { + const line = cleanPromptLine(rawLine); + if (!line) continue; + for (const pattern of patterns) { + const match = line.match(pattern); + if (match && match[1]) return clipInlineText(match[1], 180); + } + } + return ''; +} + +function buildExplorationContextFromPrompt(promptText, promptMeta, promptPath) { + const role = firstNonEmptyValue([ + readFirstEnv(['EVOLVER_EXPLORATION_ROLE', 'EVOLVE_EXPLORATION_ROLE'], 140), + findPromptValue(promptText, [ + /Identity Updated:\s*Confirmed role as\s+(.+?)(?:[.!?]|$)/i, + /\brole(?: is| as|:)\s+(.+?)(?:[.!?]|$)/i, + ]), + ]); + const persona = firstNonEmptyValue([ + readFirstEnv(['EVOLVER_EXPLORATION_PERSONA', 'EVOLVE_EXPLORATION_PERSONA'], 140), + findPromptValue(promptText, [ + /\bpersona(?: is|:)\s+(.+?)(?:[.!?]|$)/i, + /\bstyle persona(?: is|:)\s+(.+?)(?:[.!?]|$)/i, + ]), + ]); + const targetProfileId = readFirstEnv(['EVOLVER_TARGET_PROFILE_ID', 'EVOLVE_TARGET_PROFILE_ID'], 120); + const targetProfileTitle = readFirstEnv(['EVOLVER_TARGET_PROFILE_TITLE', 'EVOLVE_TARGET_PROFILE_TITLE'], 160); + const objective = firstNonEmptyValue([ + readFirstEnv([ + 'EVOLVER_EXPLORATION_OBJECTIVE', + 'EVOLVE_EXPLORATION_OBJECTIVE', + 'EVOLVER_TARGET', + 'EVOLVE_TARGET', + ], 220), + ]); + const direction = firstNonEmptyValue([ + readFirstEnv(['EVOLVER_EXPLORATION_DIRECTION', 'EVOLVE_EXPLORATION_DIRECTION'], 220), + objective, + ]); + const agent = firstNonEmptyValue([ + readFirstEnv(['EVOLVER_EXPLORATION_AGENT', 'EVOLVE_EXPLORATION_AGENT'], 80), + promptMeta && promptMeta.agent ? String(promptMeta.agent) : '', + AGENT_NAME, + ]); + return { + role: role || null, + persona: persona || null, + agent: agent || null, + target_profile_id: targetProfileId || null, + target_profile_title: targetProfileTitle || null, + exploration_objective: objective || null, + direction: direction || null, + prompt_path: promptPath || null, + }; +} + +function hasExplorationContext(context) { + const value = context && typeof context === 'object' ? context : {}; + return [ + value.role, + value.persona, + value.agent, + value.target_profile_id, + value.target_profile_title, + value.exploration_objective, + value.direction, + value.prompt_path, + ].some(item => String(item || '').trim()); +} + +function mergeExplorationContextIntoLastRun(runId, extras) { + if (!runId || !extras || typeof extras !== 'object') return; + try { + const state = readStateForSolidify(); + const lastRun = state && state.last_run ? state.last_run : null; + if (!lastRun || String(lastRun.run_id || '') !== String(runId)) return; + const nextContext = Object.assign({}, lastRun.exploration_context || {}, extras.exploration_context || {}); + lastRun.prompt_path = extras.prompt_path || lastRun.prompt_path || null; + lastRun.prompt_meta = extras.prompt_meta || lastRun.prompt_meta || null; + lastRun.exploration_context = nextContext; + lastRun.exploration_role = nextContext.role || null; + lastRun.exploration_persona = nextContext.persona || null; + lastRun.exploration_agent = nextContext.agent || null; + lastRun.target_profile_id = nextContext.target_profile_id || lastRun.target_profile_id || null; + lastRun.target_profile_title = nextContext.target_profile_title || lastRun.target_profile_title || null; + lastRun.exploration_objective = nextContext.exploration_objective || lastRun.exploration_objective || null; + lastRun.exploration_direction = nextContext.direction || lastRun.exploration_direction || null; + writeStateForSolidify(state); + } catch (e) { + console.warn('[ExplorationContext] Failed to merge context into solidify state:', e && e.message || e); + } +} + +function writeExplorationStatusContext(runInfo, explorationContext) { + if (!hasExplorationContext(explorationContext)) return null; + try { + const statusPath = path.join(getEvolutionDir(), 'exploration_status.json'); + const existing = readJsonIfExists(statusPath, {}) || {}; + const next = Object.assign({}, existing, { + timestamp: existing.timestamp || (runInfo && runInfo.created_at ? runInfo.created_at : new Date().toISOString()), + status: existing.status || 'active', + run_id: runInfo && runInfo.run_id ? runInfo.run_id : (existing.run_id || null), + cycle_id: runInfo && runInfo.cycle_id ? runInfo.cycle_id : (existing.cycle_id || null), + role: explorationContext.role || existing.role || null, + persona: explorationContext.persona || existing.persona || null, + agent: explorationContext.agent || existing.agent || null, + target_profile_id: explorationContext.target_profile_id || existing.target_profile_id || null, + target_profile_title: explorationContext.target_profile_title || existing.target_profile_title || null, + exploration_objective: explorationContext.exploration_objective || existing.exploration_objective || null, + direction: explorationContext.direction || existing.direction || null, + prompt_path: explorationContext.prompt_path || existing.prompt_path || null, + context_source: 'evolver_prompt_context', + context_updated_at: new Date().toISOString(), + }); + if (!next.message) { + next.message = 'Exploration context captured from the latest evolver prompt.'; + } + writeJsonAtomic(statusPath, next); + return next; + } catch (e) { + console.warn('[ExplorationContext] Failed to update exploration status:', e && e.message || e); + return null; + } +} + function formatSessionLog(jsonlContent) { const result = []; const lines = jsonlContent.split('\n'); @@ -1773,24 +1952,44 @@ ${mutationDirective} if (st && st.last_run && st.last_run.run_id) runId = String(st.last_run.run_id); } catch (e) {} let artifact = null; + const promptMeta = { + agent: AGENT_NAME, + drift_enabled: IS_RANDOM_DRIFT, + review_mode: IS_REVIEW_MODE, + dry_run: IS_DRY_RUN, + mutation_id: mutation && mutation.id ? mutation.id : null, + personality_key: personalitySelection && personalitySelection.personality_key ? personalitySelection.personality_key : null, + }; try { artifact = writePromptArtifact({ memoryDir: getEvolutionDir(), cycleId, runId, prompt, - meta: { - agent: AGENT_NAME, - drift_enabled: IS_RANDOM_DRIFT, - review_mode: IS_REVIEW_MODE, - dry_run: IS_DRY_RUN, - mutation_id: mutation && mutation.id ? mutation.id : null, - personality_key: personalitySelection && personalitySelection.personality_key ? personalitySelection.personality_key : null, - }, + meta: promptMeta, }); } catch (e) { artifact = null; } + try { + const explorationContext = buildExplorationContextFromPrompt( + prompt, + promptMeta, + artifact && artifact.promptPath ? artifact.promptPath : null + ); + mergeExplorationContextIntoLastRun(runId, { + prompt_path: artifact && artifact.promptPath ? artifact.promptPath : null, + prompt_meta: promptMeta, + exploration_context: explorationContext, + }); + writeExplorationStatusContext({ + run_id: runId, + cycle_id: cycleId, + created_at: new Date().toISOString(), + }, explorationContext); + } catch (e) { + console.warn('[ExplorationContext] Failed to persist prompt context:', e && e.message || e); + } const executorTask = [ 'You are the executor (the Hand).', diff --git a/src/gep/issueReporter.js b/src/gep/issueReporter.js index 2f29a25..c7810fd 100644 --- a/src/gep/issueReporter.js +++ b/src/gep/issueReporter.js @@ -11,7 +11,7 @@ const { redactString } = require('./sanitize'); const { getNodeId } = require('./a2aProtocol'); const STATE_FILE_NAME = 'issue_reporter_state.json'; -const DEFAULT_REPO = 'autogame-17/capability-evolver'; +const DEFAULT_REPO = 'autogame-17/evolver'; const DEFAULT_COOLDOWN_MS = 24 * 60 * 60 * 1000; const DEFAULT_MIN_STREAK = 5; const MAX_LOG_CHARS = 2000;