@heretek-ai/epistemic-swarm 0.4.5 → 0.4.7

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "epistemic-swarm",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "High-Integrity Dialectic Research Agent Harness for Claude Code enforcing empirical evidence over parametric hallucination.",
   "author": {
     "name": "Heretek AI",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heretek-ai/epistemic-swarm",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "IUMBTEMS: I Use My Brain To Express My Self — High-Integrity Dialectic Research Agent Harness for Claude Code, OpenCode V2, Pi, OMP (oh-my-pi), Gemini CLI, Codex CLI, and AntiGravity",
   "main": "bin/cli.js",
   "bin": {

package/plugins/antigravity/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://antigravity.google/schemas/v1/plugin.json",
   "name": "epistemic-swarm",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "IUMBTEMS Epistemic Swarm: dialectic research, code audit, OSS scout, and lateral brainstorming for AntiGravity.",
   "author": "Heretek AI",
   "license": "Apache-2.0",

package/plugins/gemini/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "epistemic-swarm",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "IUMBTEMS Epistemic Swarm: dialectic research, code audit, OSS scout, and lateral brainstorming for Gemini CLI.",
   "mcpServers": {
     "brave-search": {

package/plugins/opencode/index.js

@@ -563,6 +563,10 @@ export function buildCompactionContext(root) {
 
 const NUDGE_MIN_INTERVAL_MS = 5 * 60 * 1000;
 const activeNudges = new Map();
+// Cleanup functions for the setup() disposer (a setup that returns a plain
+// object crashes host reload: the host calls the return value as a cleanup
+// function). All setup-owned resources register here.
+const setupCleanups = new Set();
 
 /**
  * Handle one subscribed event: nudge once per ledger change when degraded
@@ -661,36 +665,9 @@ export function createOpenCodePlugin(context = {}) {
     setup: async (appContext) => {
       const host = appContext || {};
       const opts = context.options || host.options;
-      if (opts && typeof opts === 'object') {
-        const updates = {};
-        if (opts.search_engine) updates.search_engine = opts.search_engine;
-        if (opts.max_iterations) updates.max_iterations = opts.max_iterations;
-        if (opts.mode) updates.mode = opts.mode;
-        if (opts.divergence_threshold !== undefined) {
-          updates.divergence_threshold = opts.divergence_threshold;
-        }
-        if (Object.keys(updates).length > 0) {
-          await callMcp('iumbtems_config', updates, host.cwd);
-        }
-      }
-      // Phase C: idle staleness nudge (opt out with {staleness_nudge: false}).
-      // Subscribes only when the host exposes event/session; one per root.
-      try {
-        if ((opts?.staleness_nudge ?? true)) {
-          const nudgeHost = {
-            event: host.event || context.event,
-            session: host.session || context.session,
-          };
-          const root =
-            host.location?.directory || context.location?.directory;
-          if (root) startStalenessNudge(nudgeHost, root);
-        }
-      } catch {
-        /* lifecycle hooks are best-effort */
-      }
-      // V2 host transforms (official dual-package pattern: V1 calls server(),
-      // V2 calls setup()). Registers slash commands + tools via the owning
-      // domains; each guarded so V1 hosts and partial V2 hosts keep working.
+      // V2 host transforms FIRST (official dual-package pattern: V1 calls
+      // server(), V2 calls setup()). Registration must precede any slow
+      // work: the host may not wait out subprocess calls before reconciling.
       try {
         if (host.command && typeof host.command.transform === 'function') {
           let existing = new Set();
@@ -744,7 +721,60 @@ export function createOpenCodePlugin(context = {}) {
       } catch {
         /* tool transform is best-effort */
       }
-      return { initialized: true, platform: 'opencode-v2' };
+      // Slow work AFTER registration: apply tuple options via MCP config
+      // write, scoped to the plugin location (never the service cwd).
+      try {
+        if (opts && typeof opts === 'object') {
+          const updates = {};
+          if (opts.search_engine) updates.search_engine = opts.search_engine;
+          if (opts.max_iterations) updates.max_iterations = opts.max_iterations;
+          if (opts.mode) updates.mode = opts.mode;
+          if (opts.divergence_threshold !== undefined) {
+            updates.divergence_threshold = opts.divergence_threshold;
+          }
+          if (Object.keys(updates).length > 0) {
+            await callMcp(
+              'iumbtems_config',
+              updates,
+              host.location?.directory || context.location?.directory || host.cwd
+            );
+          }
+        }
+      } catch {
+        /* options apply is best-effort */
+      }
+      // Phase C: idle staleness nudge (opt out with {staleness_nudge: false}).
+      // Subscribes only when the host exposes event/session; one per root.
+      try {
+        if ((opts?.staleness_nudge ?? true)) {
+          const nudgeHost = {
+            event: host.event || context.event,
+            session: host.session || context.session,
+          };
+          const root =
+            host.location?.directory || context.location?.directory;
+          if (root) {
+            const stop = startStalenessNudge(nudgeHost, root);
+            if (typeof stop === 'function') setupCleanups.add(stop);
+          }
+        }
+      } catch {
+        /* lifecycle hooks are best-effort */
+      }
+      // Disposer: the host calls setup's return value as a cleanup function
+      // on unload/reload. It MUST be a function (returning a plain object
+      // crashes host reload with "not a function"). Aborts nudge streams so
+      // reloads never stack duplicate subscriptions.
+      return () => {
+        for (const stop of [...setupCleanups]) {
+          setupCleanups.delete(stop);
+          try {
+            stop();
+          } catch {
+            /* cleanup is best-effort */
+          }
+        }
+      };
     },
   };
 }

package/runner/tests/test_opencode_ux.py

@@ -493,7 +493,7 @@ class TestOpenCodeV2Transforms(unittest.TestCase):
             self.V2_SETUP
             % """
             console.log(JSON.stringify({
-              ret: ret.initialized,
+              cleanupFn: typeof ret === "function",
               commands: addedCommands.map(c => c.name),
               cmdExec: typeof addedCommands.find(c => c.name === "swarm").execute,
               tools: addedTools.map(t => t.name),
@@ -503,7 +503,7 @@ class TestOpenCodeV2Transforms(unittest.TestCase):
         )
         self.assertEqual(res.returncode, 0, f"v2 transform test failed: {res.stderr}")
         data = last_json_object(res.stdout)
-        self.assertTrue(data["ret"])
+        self.assertEqual(data["cleanupFn"], True)
         for c in [
             "swarm",
             "grill",
@@ -556,12 +556,67 @@ class TestOpenCodeV2Transforms(unittest.TestCase):
             """
             import plugin from "./plugins/opencode/index.js";
             const ret = await plugin.setup({});
-            console.log(JSON.stringify({ret: ret.initialized}));
+            ret();
+            ret();
+            console.log(JSON.stringify({cleanupFn: typeof ret === "function"}));
             """
         )
         self.assertEqual(res.returncode, 0, f"bare setup test failed: {res.stderr}")
         data = last_json_object(res.stdout)
-        self.assertTrue(data["ret"])
+        self.assertEqual(data["cleanupFn"], True)
+
+    def test_options_applied_to_location_dir_after_transforms(self):
+        import tempfile
+
+        with tempfile.TemporaryDirectory() as tmp:
+            res = run_node(
+                f"""
+                import plugin from "./plugins/opencode/index.js";
+                const added = [];
+                const host = {{
+                  options: {{mode: "audit"}},
+                  location: {{directory: {tmp!r}}},
+                  command: {{
+                    list: async () => ({{data: []}}),
+                    transform: async (fn) => {{ fn({{add: (d) => added.push(d.name)}}); }}
+                  }},
+                  tool: {{transform: async () => {{}}}}
+                }};
+                await plugin.setup(host);
+                console.log(JSON.stringify({{commands: added}}));
+                """
+            )
+            self.assertEqual(res.returncode, 0, f"options test failed: {res.stderr}")
+            data = last_json_object(res.stdout)
+            # Transforms registered despite the slow MCP options write.
+            self.assertIn("swarm", data["commands"])
+            cfg = json.loads(
+                Path(tmp, ".research", "config.json").read_text(encoding="utf-8")
+            )
+            self.assertEqual(cfg.get("mode"), "audit")
+
+    def test_setup_cleanup_aborts_nudge_streams(self):
+        res = run_node(
+            """
+            import plugin from "./plugins/opencode/index.js";
+            const seen = [];
+            const host = {
+              options: {},
+              location: {directory: "/tmp/oc-nudge-cleanup"},
+              event: {subscribe: (opts) => { seen.push(opts && opts.signal); return {[Symbol.asyncIterator]() { return {next: async () => ({done: true})}; }}; }},
+              session: {prompt: async () => ({})}
+            };
+            const cleanup = await plugin.setup(host);
+            const before = seen.length;
+            cleanup();
+            console.log(JSON.stringify({subscribed: before > 0, cleanupFn: typeof cleanup === "function", aborted: seen.length > 0 && seen[0].aborted === true}));
+            """
+        )
+        self.assertEqual(res.returncode, 0, f"cleanup test failed: {res.stderr}")
+        data = last_json_object(res.stdout)
+        self.assertTrue(data["subscribed"])
+        self.assertTrue(data["cleanupFn"])
+        self.assertTrue(data["aborted"])
 
 
 if __name__ == "__main__":