@evomap/evolver 1.79.1 → 1.80.0

package/README.md

@@ -136,6 +136,9 @@ Evolver integrates with major agent runtimes through `setup-hooks`. Run it once
 |---|---|---|
 | [Cursor](https://cursor.com) | `evolver setup-hooks --platform=cursor` | `~/.cursor/hooks.json` + scripts in `~/.cursor/hooks/`. Restart Cursor or open a new session. Fires on `sessionStart`, `afterFileEdit`, `stop`. |
 | [Claude Code](https://www.anthropic.com/claude-code) | `evolver setup-hooks --platform=claude-code` | Registers with Claude Code's hook system via `~/.claude/`. Restart the Claude Code CLI. |
+| [Codex](https://github.com/openai/codex) | `evolver setup-hooks --platform=codex` | `~/.codex/hooks.json` + scripts in `~/.codex/hooks/`, enables `codex_hooks` feature in `config.toml`. Restart the Codex CLI. |
+| [Kiro](https://kiro.dev) | `evolver setup-hooks --platform=kiro` | Three `*.kiro.hook` files + scripts in `~/.kiro/hooks/`. Auto-discovered, no restart needed. |
+| [opencode](https://opencode.ai) | `evolver setup-hooks --platform=opencode` | Plugin at `~/.opencode/plugins/evolver.js` + scripts in `~/.opencode/hooks/`. Restart opencode. |
 | [OpenClaw](https://openclaw.com) | No setup needed | OpenClaw natively interprets the `sessions_spawn(...)` stdout directives Evolver emits. Just run `evolver` from inside an OpenClaw session. |
 
 ## Run from Source (Contributors Only)

package/assets/gep/candidates.jsonl

@@ -1,2 +1 @@
-{"type":"CapabilityCandidate","id":"cand_b9a66a5c","title":"Harden session log detection and fallback behavior","source":"signals","created_at":"2026-05-06T01:46:54.543Z","signals":["memory_missing","user_missing","session_logs_missing"],"tags":["memory_missing","user_missing","session_logs_missing","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: 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-05-06T01:47:23.332Z","signals":["memory_missing","user_missing","session_logs_missing"],"tags":["memory_missing","user_missing","session_logs_missing","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: 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-05-07T04:15:16.667Z","signals":["memory_missing","user_missing","session_logs_missing"],"tags":["memory_missing","user_missing","session_logs_missing","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: 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/index.js

@@ -1682,7 +1682,7 @@ async function main() {
   - distill flags:
     - --response-file=<path>  (LLM response file for skill distillation)
   - setup-hooks flags:
-    - --platform=cursor|claude-code|codex  (auto-detect if omitted)
+    - --platform=cursor|claude-code|codex|kiro|opencode  (auto-detect if omitted)
     - --force                              (overwrite existing config)
     - --uninstall                          (remove evolver hooks)
   - asset-log flags:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evomap/evolver",
-  "version": "1.79.1",
+  "version": "1.80.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/adapters/hookAdapter.js

@@ -7,6 +7,7 @@ const PLATFORMS = {
   'claude-code': { name: 'Claude Code', configDir: '.claude', detector: '.claude' },
   codex: { name: 'Codex', configDir: '.codex', detector: '.codex' },
   kiro: { name: 'Kiro', configDir: '.kiro', detector: '.kiro' },
+  opencode: { name: 'opencode', configDir: '.opencode', detector: '.opencode' },
 };
 
 function detectPlatform(cwd) {
@@ -37,6 +38,7 @@ function loadAdapter(platformId) {
     case 'claude-code': return require('./claudeCode');
     case 'codex': return require('./codex');
     case 'kiro': return require('./kiro');
+    case 'opencode': return require('./opencode');
     default: return null;
   }
 }
@@ -165,7 +167,7 @@ async function setupHooks({ platform, cwd, force, uninstall, evolverRoot } = {})
   const platformId = platform || detectPlatform(effectiveCwd);
 
   if (!platformId) {
-    console.error('[setup-hooks] Could not detect platform. Use --platform=cursor|claude-code|codex|kiro');
+    console.error('[setup-hooks] Could not detect platform. Use --platform=cursor|claude-code|codex|kiro|opencode');
     return { ok: false, error: 'platform_not_detected' };
   }
 

package/src/adapters/opencode.js

@@ -0,0 +1,199 @@
+const fs = require('fs');
+const path = require('path');
+const { copyHookScripts, removeHookScripts } = require('./hookAdapter');
+
+const HOOK_SCRIPTS_DIR_NAME = 'hooks';
+const PLUGINS_DIR_NAME = 'plugins';
+const PLUGIN_FILE_NAME = 'evolver.js';
+const EVOLVER_MARKER = '<!-- evolver-evolution-memory -->';
+// First line of the plugin file. Used to (a) prove the plugin file is one we
+// wrote, so uninstall can safely delete it, and (b) skip overwriting if the
+// user replaced it with a custom plugin.
+const PLUGIN_HEADER = '// _evolver_managed: true (do not remove this line)';
+
+function buildPluginSource(hooksDirAbsolute) {
+  // The plugin shells out to the same three Node scripts that every other
+  // evolver adapter uses, so the runtime behavior stays consistent across
+  // hosts. opencode loads .js files synchronously at startup and invokes
+  // the default-exported async factory with a context object.
+  return `${PLUGIN_HEADER}
+// Auto-generated by \`evolver setup-hooks --platform=opencode\`.
+// See https://opencode.ai/docs/plugins/ for the plugin API.
+//
+// This plugin wires opencode events to the three evolver hook scripts:
+//   session.created      -> evolver-session-start.js  (inject memory)
+//   tool.execute.after   -> evolver-signal-detect.js  (detect signals on writes/edits)
+//   session.idle         -> evolver-session-end.js    (record outcome)
+//
+// Each script is a stdin/stdout JSON filter -- nothing else is shared with
+// opencode, so removing this file fully detaches evolver from opencode.
+
+const { spawnSync } = require('node:child_process');
+const path = require('node:path');
+
+const HOOKS_DIR = ${JSON.stringify(hooksDirAbsolute)};
+
+function runHook(scriptName, payload, timeoutMs) {
+  try {
+    const result = spawnSync('node', [path.join(HOOKS_DIR, scriptName)], {
+      input: JSON.stringify(payload || {}),
+      encoding: 'utf8',
+      timeout: timeoutMs,
+    });
+    if (!result || !result.stdout) return {};
+    try { return JSON.parse(result.stdout); } catch { return {}; }
+  } catch {
+    return {};
+  }
+}
+
+const Evolver = async () => ({
+  event: async ({ event }) => {
+    if (!event || typeof event.type !== 'string') return;
+    if (event.type === 'session.created') {
+      runHook('evolver-session-start.js', {
+        session_id: event.properties && event.properties.info && event.properties.info.id,
+      }, 3000);
+      return;
+    }
+    if (event.type === 'session.idle') {
+      runHook('evolver-session-end.js', {
+        session_id: event.properties && event.properties.sessionID,
+      }, 8000);
+    }
+  },
+  'tool.execute.after': async (input, output) => {
+    if (!input || typeof input.tool !== 'string') return;
+    if (input.tool !== 'write' && input.tool !== 'edit') return;
+    runHook('evolver-signal-detect.js', {
+      tool_input: (output && output.args) || {},
+      tool_response: (output && output.output) || (output && output.result) || {},
+    }, 2000);
+  },
+});
+
+module.exports = { Evolver };
+module.exports.default = Evolver;
+`;
+}
+
+function buildAgentsMdSection() {
+  return `${EVOLVER_MARKER}
+## Evolution Memory (Evolver)
+
+This project uses evolver for self-evolution. Hooks automatically:
+1. Inject recent evolution memory at session start
+2. Detect evolution signals during file edits
+3. Record outcomes at session end
+
+For substantive tasks, call \`gep_recall\` before work and \`gep_record_outcome\` after.
+Signals: log_error, perf_bottleneck, user_feature_request, capability_gap, deployment_issue, test_failure.`;
+}
+
+function appendSectionToFile(filePath, marker, content) {
+  let existing = '';
+  try { existing = fs.readFileSync(filePath, 'utf8'); } catch { /* new file */ }
+  if (existing.includes(marker)) return false;
+  const separator = existing.length > 0 && !existing.endsWith('\n') ? '\n\n' : '\n';
+  fs.writeFileSync(filePath, existing + separator + content + '\n', 'utf8');
+  return true;
+}
+
+function isEvolverManagedPluginFile(filePath) {
+  try {
+    if (!fs.existsSync(filePath)) return false;
+    const raw = fs.readFileSync(filePath, 'utf8');
+    return raw.includes('_evolver_managed: true');
+  } catch {
+    return false;
+  }
+}
+
+function writePluginFile(pluginsDir, source) {
+  fs.mkdirSync(pluginsDir, { recursive: true });
+  const dest = path.join(pluginsDir, PLUGIN_FILE_NAME);
+  const tmp = dest + '.tmp';
+  fs.writeFileSync(tmp, source, 'utf8');
+  fs.renameSync(tmp, dest);
+  return dest;
+}
+
+function install({ configRoot, evolverRoot, force }) {
+  const opencodeDir = path.join(configRoot, '.opencode');
+  const hooksDir = path.join(opencodeDir, HOOK_SCRIPTS_DIR_NAME);
+  const pluginsDir = path.join(opencodeDir, PLUGINS_DIR_NAME);
+  const pluginPath = path.join(pluginsDir, PLUGIN_FILE_NAME);
+  const agentsMdPath = path.join(configRoot, 'AGENTS.md');
+
+  if (!force && isEvolverManagedPluginFile(pluginPath)) {
+    console.log('[opencode] Evolver plugin already installed. Use --force to overwrite.');
+    return { ok: true, skipped: true };
+  }
+
+  fs.mkdirSync(opencodeDir, { recursive: true });
+
+  const written = writePluginFile(pluginsDir, buildPluginSource(hooksDir));
+  console.log('[opencode] Wrote ' + written);
+
+  const copied = copyHookScripts(hooksDir, path.join(evolverRoot, 'src', 'adapters'));
+  console.log('[opencode] Copied ' + copied.length + ' hook scripts to ' + hooksDir);
+
+  const injected = appendSectionToFile(agentsMdPath, EVOLVER_MARKER, buildAgentsMdSection());
+  if (injected) {
+    console.log('[opencode] Injected evolution section into ' + agentsMdPath);
+  }
+
+  console.log('[opencode] Installation complete.');
+  console.log('[opencode] opencode auto-loads plugins from .opencode/plugins/ -- restart opencode to activate.');
+
+  return {
+    ok: true,
+    platform: 'opencode',
+    files: [written, agentsMdPath, ...copied],
+  };
+}
+
+function uninstall({ configRoot }) {
+  const opencodeDir = path.join(configRoot, '.opencode');
+  const hooksDir = path.join(opencodeDir, HOOK_SCRIPTS_DIR_NAME);
+  const pluginsDir = path.join(opencodeDir, PLUGINS_DIR_NAME);
+  const pluginPath = path.join(pluginsDir, PLUGIN_FILE_NAME);
+  const agentsMdPath = path.join(configRoot, 'AGENTS.md');
+
+  let changed = false;
+
+  if (isEvolverManagedPluginFile(pluginPath)) {
+    try { fs.unlinkSync(pluginPath); changed = true; } catch { /* ignore */ }
+  }
+
+  const scripts = removeHookScripts(hooksDir);
+  if (scripts > 0) changed = true;
+
+  try {
+    if (fs.existsSync(agentsMdPath)) {
+      let content = fs.readFileSync(agentsMdPath, 'utf8');
+      if (content.includes(EVOLVER_MARKER)) {
+        const idx = content.indexOf(EVOLVER_MARKER);
+        const nextSection = content.indexOf('\n## ', idx + EVOLVER_MARKER.length);
+        const endIdx = nextSection !== -1 ? nextSection : content.length;
+        content = content.slice(0, idx).trimEnd() + (nextSection !== -1 ? content.slice(endIdx) : '');
+        fs.writeFileSync(agentsMdPath, content.trimEnd() + '\n', 'utf8');
+        changed = true;
+      }
+    }
+  } catch { /* ignore */ }
+
+  console.log(changed
+    ? '[opencode] Uninstalled evolver plugin and hooks.'
+    : '[opencode] No evolver plugin found to uninstall.');
+
+  return { ok: true, removed: changed };
+}
+
+module.exports = {
+  install,
+  uninstall,
+  buildPluginSource,
+  isEvolverManagedPluginFile,
+  PLUGIN_FILE_NAME,
+};