Release v1.80.7

Author: evolver-publish

index.js

@@ -1559,12 +1559,43 @@ async function main() {
     }
 
   } else if (command === 'setup-hooks') {
-    const { setupHooks } = require('./src/adapters/hookAdapter');
+    const hookAdapter = require('./src/adapters/hookAdapter');
+    const { setupHooks, resolveConfigRoot, detectPlatform, loadAdapter } = hookAdapter;
 
     const platformFlag = args.find(a => typeof a === 'string' && a.startsWith('--platform='));
     const platform = platformFlag ? platformFlag.slice('--platform='.length) : undefined;
     const force = args.includes('--force');
     const uninstall = args.includes('--uninstall');
+    const verifyOnly = args.includes('--verify');
+
+    if (verifyOnly) {
+      // Read-only verification: do not touch any files, just report whether
+      // the previously-installed hooks/plugin look healthy. Lets users answer
+      // "is the plugin actually loaded?" without grepping opencode logs.
+      try {
+        const platformId = platform || detectPlatform(process.cwd());
+        if (!platformId) {
+          console.error('[setup-hooks] --verify: could not detect platform. Pass --platform=opencode|cursor|claude-code|codex|kiro');
+          process.exit(2);
+        }
+        const adapter = loadAdapter(platformId);
+        if (!adapter || typeof adapter.verify !== 'function') {
+          console.error('[setup-hooks] --verify: platform ' + platformId + ' does not support verification yet.');
+          process.exit(2);
+        }
+        const configRoot = resolveConfigRoot(platformId, process.cwd());
+        const report = adapter.verify({ configRoot });
+        if (typeof adapter.printVerifyReport === 'function') {
+          adapter.printVerifyReport(report);
+        } else {
+          console.log(JSON.stringify(report, null, 2));
+        }
+        process.exit(report.ok ? 0 : 1);
+      } catch (verifyErr) {
+        console.error('[setup-hooks] --verify error:', verifyErr && verifyErr.message || verifyErr);
+        process.exit(1);
+      }
+    }
 
     try {
       const result = await setupHooks({
@@ -1685,6 +1716,7 @@ async function main() {
     - --platform=cursor|claude-code|codex|kiro|opencode  (auto-detect if omitted)
     - --force                              (overwrite existing config)
     - --uninstall                          (remove evolver hooks)
+    - --verify                             (read-only: print install health for the chosen platform)
   - asset-log flags:
     - --run=<run_id>           (filter by run ID)
     - --action=<action>        (filter: hub_search_hit, hub_search_miss, asset_reuse, asset_reference, asset_publish, asset_publish_skip)

package.json

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

src/adapters/opencode.js

@@ -127,7 +127,8 @@ function install({ configRoot, evolverRoot, force }) {
 
   if (!force && isEvolverManagedPluginFile(pluginPath)) {
     console.log('[opencode] Evolver plugin already installed. Use --force to overwrite.');
-    return { ok: true, skipped: true };
+    printPostInstallNotice(pluginPath);
+    return { ok: true, skipped: true, plugin_path: pluginPath };
   }
 
   fs.mkdirSync(opencodeDir, { recursive: true });
@@ -144,15 +145,147 @@ function install({ configRoot, evolverRoot, force }) {
   }
 
   console.log('[opencode] Installation complete.');
-  console.log('[opencode] opencode auto-loads plugins from .opencode/plugins/ -- restart opencode to activate.');
+  printPostInstallNotice(written);
 
   return {
     ok: true,
     platform: 'opencode',
+    plugin_path: written,
     files: [written, agentsMdPath, ...copied],
   };
 }
 
+function printPostInstallNotice(pluginPath) {
+  // The opencode TUI "Plugins" tab only lists TUI plugins (registered via
+  // tui.json with `default export { id, tui }`). Server plugins like ours,
+  // auto-loaded from .opencode/plugins/, are functional but invisible in
+  // that tab. This is by opencode design, not a bug. See:
+  //   https://github.com/sst/opencode -> packages/opencode/specs/tui-plugins.md
+  // Surfacing this proactively here prevents the "is it actually loaded?"
+  // confusion that motivated EvoMap/evolver issue #531.
+  console.log('');
+  console.log('[opencode] Restart opencode for the plugin to take effect.');
+  console.log('[opencode] Note: this is a SERVER plugin (event hooks). It will NOT appear in');
+  console.log('[opencode]       the TUI "Plugins" tab -- that tab only lists TUI plugins');
+  console.log('[opencode]       (registered via tui.json). The plugin is still loaded and');
+  console.log('[opencode]       running silently in the background.');
+  console.log('[opencode] To verify the plugin is loaded, run:');
+  console.log('[opencode]   opencode --print-logs --log-level INFO debug config 2>&1 | grep ' + JSON.stringify(pluginPath));
+  console.log('[opencode] Or run:');
+  console.log('[opencode]   evolver setup-hooks --platform=opencode --verify');
+}
+
+// Walk the install state and report what is healthy / what is missing.
+// Used by the `--verify` flag to give users a definitive answer to
+// "is the plugin actually installed and loadable?". Returns a structured
+// result so callers (CLI, future TUI plugin) can format it as they like.
+function verify({ 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');
+  const expectedScripts = [
+    'evolver-session-start.js',
+    'evolver-signal-detect.js',
+    'evolver-session-end.js',
+  ];
+
+  const checks = [];
+
+  const pluginExists = fs.existsSync(pluginPath);
+  checks.push({
+    id: 'plugin_file_present',
+    ok: pluginExists,
+    detail: pluginExists ? pluginPath : 'missing: ' + pluginPath,
+  });
+
+  const managed = pluginExists && isEvolverManagedPluginFile(pluginPath);
+  checks.push({
+    id: 'plugin_managed_marker',
+    ok: managed,
+    detail: managed
+      ? 'first line contains _evolver_managed: true'
+      : 'plugin file is not evolver-managed (was it edited or replaced by another tool?)',
+  });
+
+  let pluginLoadable = false;
+  let pluginLoadError = null;
+  if (pluginExists) {
+    try {
+      // Require the plugin in an isolated module cache slot to confirm it
+      // parses and exports the expected shape. opencode does an ESM dynamic
+      // import; CommonJS require here is a strict subset of that, so a
+      // failure here is a guaranteed failure under opencode too.
+      delete require.cache[require.resolve(pluginPath)];
+      const mod = require(pluginPath);
+      const fn = mod && (mod.Evolver || mod.default);
+      pluginLoadable = typeof fn === 'function';
+      if (!pluginLoadable) pluginLoadError = 'no Evolver/default function export';
+    } catch (err) {
+      pluginLoadError = (err && err.message) || String(err);
+    }
+  }
+  checks.push({
+    id: 'plugin_loadable',
+    ok: pluginLoadable,
+    detail: pluginLoadable
+      ? 'require() succeeded and exports Evolver()'
+      : 'require() failed: ' + (pluginLoadError || 'unknown'),
+  });
+
+  const missingScripts = expectedScripts.filter(
+    (name) => !fs.existsSync(path.join(hooksDir, name))
+  );
+  checks.push({
+    id: 'hook_scripts_present',
+    ok: missingScripts.length === 0,
+    detail: missingScripts.length === 0
+      ? 'all 3 hook scripts present in ' + hooksDir
+      : 'missing: ' + missingScripts.join(', '),
+  });
+
+  let agentsMdHasSection = false;
+  try {
+    if (fs.existsSync(agentsMdPath)) {
+      agentsMdHasSection = fs.readFileSync(agentsMdPath, 'utf8').includes(EVOLVER_MARKER);
+    }
+  } catch { /* ignore */ }
+  checks.push({
+    id: 'agents_md_section',
+    ok: agentsMdHasSection,
+    detail: agentsMdHasSection
+      ? 'AGENTS.md contains evolution memory section'
+      : 'AGENTS.md is missing or has no evolution section (re-run install)',
+  });
+
+  const allOk = checks.every((c) => c.ok);
+
+  return {
+    ok: allOk,
+    plugin_path: pluginPath,
+    hooks_dir: hooksDir,
+    config_root: configRoot,
+    checks,
+    note: allOk
+      ? 'Plugin is installed and loadable. opencode\'s TUI "Plugins" tab will not list it -- that tab only shows TUI plugins. Run `opencode --print-logs --log-level INFO debug config` and grep for the plugin path to confirm opencode loads it at startup.'
+      : 'One or more checks failed. Re-run `evolver setup-hooks --platform=opencode --force` to repair.',
+  };
+}
+
+function printVerifyReport(report) {
+  console.log('[opencode] Verify report');
+  console.log('[opencode]   plugin path : ' + report.plugin_path);
+  console.log('[opencode]   hooks dir   : ' + report.hooks_dir);
+  console.log('[opencode]   config root : ' + report.config_root);
+  console.log('[opencode] Checks:');
+  for (const c of report.checks) {
+    console.log('[opencode]   ' + (c.ok ? '[OK]  ' : '[FAIL]') + ' ' + c.id + ' -- ' + c.detail);
+  }
+  console.log('[opencode] ' + (report.ok ? 'All checks passed.' : 'Some checks failed.'));
+  console.log('[opencode] ' + report.note);
+}
+
 function uninstall({ configRoot }) {
   const opencodeDir = path.join(configRoot, '.opencode');
   const hooksDir = path.join(opencodeDir, HOOK_SCRIPTS_DIR_NAME);
@@ -193,6 +326,8 @@ function uninstall({ configRoot }) {
 module.exports = {
   install,
   uninstall,
+  verify,
+  printVerifyReport,
   buildPluginSource,
   isEvolverManagedPluginFile,
   PLUGIN_FILE_NAME,