@heretek-ai/epistemic-swarm 0.4.6 → 0.4.8

package/.claude-plugin/plugin.json

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

package/bin/cli.js

@@ -5,9 +5,28 @@
  * High-Integrity Dialectic Research Harness for Claude Code, Pi, OMP, OpenCode V2, Gemini CLI, Codex CLI, AntiGravity.
  */
 
-const { spawnSync } = require('child_process');
-const path = require('path');
-const fs = require('fs');
+const { spawnSync } = require('node:child_process');
+const path = require('node:path');
+const fs = require('node:fs');
+
+function resolveBinary(name) {
+  const pathDirs = (process.env.PATH || '').split(path.delimiter);
+  for (const dir of pathDirs) {
+    if (!dir || dir === '.' || dir.startsWith('./') || dir.startsWith('../')) continue;
+    const full = path.join(dir, name);
+    try {
+      // Match Node's own PATH search: skip non-files and non-executables so a
+      // directory or a non-executable named `python3` earlier on PATH cannot
+      // shadow the real binary.
+      if (!fs.statSync(full).isFile()) continue;
+      fs.accessSync(full, fs.constants.X_OK);
+      return fs.realpathSync(full);
+    } catch {
+      /* not present, not a file, or not executable — keep searching */
+    }
+  }
+  return name;
+}
 
 const PKG_ROOT = path.resolve(__dirname, '..');
 const args = process.argv.slice(2);
@@ -74,7 +93,7 @@ function runPython(scriptRelPath, extraArgs = []) {
     const scriptPath = path.join(PKG_ROOT, scriptRelPath);
     finalArgs = [scriptPath, ...extraArgs];
   }
-  const result = spawnSync('python3', finalArgs, {
+  const result = spawnSync(resolveBinary('python3'), finalArgs, {
     stdio: 'inherit',
     cwd: process.cwd(),
     env: { ...process.env, PYTHONPATH: PKG_ROOT }
@@ -84,7 +103,7 @@ function runPython(scriptRelPath, extraArgs = []) {
 
 function runBash(scriptRelPath, extraArgs = []) {
   const scriptPath = path.join(PKG_ROOT, scriptRelPath);
-  const result = spawnSync('bash', [scriptPath, ...extraArgs], {
+  const result = spawnSync(resolveBinary('bash'), [scriptPath, ...extraArgs], {
     stdio: 'inherit',
     cwd: process.cwd()
   });
@@ -186,18 +205,51 @@ switch (command) {
 
   case 'doctor': {
     console.log('🔍 Checking Epistemic Swarm Environment:\n');
-    const claudeCheck = spawnSync('claude', ['--version'], { encoding: 'utf-8' });
+
+    let pkgVersion = 'unknown';
+    try {
+      pkgVersion = JSON.parse(fs.readFileSync(path.join(PKG_ROOT, 'package.json'), 'utf8')).version || 'unknown';
+    } catch { /* keep 'unknown' */ }
+    console.log(`✅ epistemic-swarm: ${pkgVersion}`);
+
+    const claudeCheck = spawnSync(resolveBinary('claude'), ['--version'], { encoding: 'utf-8' });
     if (claudeCheck.status === 0) {
       console.log(`✅ Claude Code: ${claudeCheck.stdout.trim()}`);
     } else {
       console.log('⚠️ Claude Code CLI not found in PATH (Install via npm i -g @anthropic-ai/claude-code)');
     }
 
-    const pyCheck = spawnSync('python3', ['--version'], { encoding: 'utf-8' });
+    const pyCheck = spawnSync(resolveBinary('python3'), ['--version'], { encoding: 'utf-8' });
     console.log(`✅ Python: ${pyCheck.stdout ? pyCheck.stdout.trim() : 'python3 missing'}`);
 
     console.log(`✅ Node.js: ${process.version}`);
     console.log(`📁 Package Root: ${PKG_ROOT}`);
+
+    // opencode resolves this package as `@latest` into a per-fetch cache and
+    // keeps every generation. A session started against an old generation keeps
+    // running the old code until it is refreshed, so report what is cached.
+    try {
+      const cacheRoot = path.join(process.env.HOME || '', '.cache', 'opencode', 'npm', '@heretek-ai');
+      const pkgDir = path.join(cacheRoot, 'epistemic-swarm@latest');
+      if (fs.existsSync(pkgDir)) {
+        const generations = fs.readdirSync(pkgDir).filter((d) => /^\d+$/.test(d)).sort();
+        const newest = generations[generations.length - 1];
+        console.log(`\n🧩 OpenCode plugin cache: ${generations.length} generation(s) in ${pkgDir}`);
+        for (const g of generations.slice(-5)) {
+          const marker = g === newest ? '  <- newest' : '';
+          console.log(`   - ${g}${marker}`);
+        }
+        if (generations.length > 1) {
+          console.log('   ⚠️ Multiple generations cached. If slash commands vanish or the plugin');
+          console.log('      misbehaves, the running session may hold an older one — refresh with');
+          console.log('      `opencode plugin update` (or clear the cache dir) and relaunch.');
+        }
+      } else {
+        console.log('\n🧩 OpenCode plugin cache: not present (plugin not yet fetched)');
+      }
+    } catch (err) {
+      console.log(`\n🧩 OpenCode plugin cache: could not inspect (${err.message})`);
+    }
     break;
   }
 

package/config/mcp_launcher.py

@@ -8,12 +8,11 @@ Safely detects API keys and endpoints:
 Prevents startup crashes and missing environment variable errors in Claude Code.
 """
 
-import sys
-import os
 import json
-import subprocess
+import os
 import shutil
-from typing import Dict, Any, List
+import sys
+from typing import Any, Dict, List, Optional
 
 # Add parent dir to path for imports
 SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
@@ -21,32 +20,30 @@ PROJECT_ROOT = os.path.abspath(os.path.join(SCRIPT_DIR, ".."))
 if PROJECT_ROOT not in sys.path:
     sys.path.insert(0, PROJECT_ROOT)
 
+
 def get_config_val(key: str, default: str = "") -> str:
     """Retrieve config from env, userConfig, or defaults."""
     env_val = os.environ.get(key)
     if env_val:
         return env_val
-    # Also check user_config format
     user_cfg_val = os.environ.get(f"CLAUDE_PLUGIN_OPTION_{key.upper()}")
     if user_cfg_val:
         return user_cfg_val
     return default
 
-def run_zero_key_mcp_server(service: str):
-    """Run lightweight JSON-RPC MCP server handling search and fetch without API keys."""
+
+def _build_brave_tools() -> list:
+    from runner.mcp_protocol import ToolSpec
     from skills.epistemic_search.scripts.search import search_duckduckgo
-    from skills.epistemic_search.scripts.fetch import fetch_and_cache
-    from runner.mcp_protocol import StdioJsonRpcServer, ToolSpec
 
-    tools = []
-    if service == "brave-search":
-        def handle_brave_search(args: Dict[str, Any]) -> str:
-            results = search_duckduckgo(
-                query=args.get("query", ""), max_results=args.get("count", 10)
-            )
-            return json.dumps(results, indent=2)
+    def handle_brave_search(args: Dict[str, Any]) -> str:
+        results = search_duckduckgo(
+            query=args.get("query", ""), max_results=args.get("count", 10)
+        )
+        return json.dumps(results, indent=2)
 
-        tools.append(ToolSpec(
+    return [
+        ToolSpec(
             name="brave_web_search",
             description="Web search with DuckDuckGo fallback (zero API key required). Returns verifiable search results with titles, URLs, and snippets.",
             input_schema={
@@ -59,12 +56,19 @@ def run_zero_key_mcp_server(service: str):
             },
             handler=handle_brave_search,
             aliases=("search",),
-        ))
-    elif service == "firecrawl":
-        def handle_firecrawl_scrape(args: Dict[str, Any]) -> str:
-            return fetch_and_cache(url=args.get("url", ""))
+        )
+    ]
+
+
+def _build_firecrawl_tools() -> list:
+    from runner.mcp_protocol import ToolSpec
+    from skills.epistemic_search.scripts.fetch import fetch_and_cache
 
-        tools.append(ToolSpec(
+    def handle_firecrawl_scrape(args: Dict[str, Any]) -> str:
+        return fetch_and_cache(url=args.get("url", ""))
+
+    return [
+        ToolSpec(
             name="firecrawl_scrape",
             description="Scrape and extract clean markdown with automatic content-addressed SHA-256 caching into .research/sources/.",
             input_schema={
@@ -76,7 +80,20 @@ def run_zero_key_mcp_server(service: str):
             },
             handler=handle_firecrawl_scrape,
             aliases=("scrape", "fetch"),
-        ))
+        )
+    ]
+
+
+def run_zero_key_mcp_server(service: str):
+    """Run lightweight JSON-RPC MCP server handling search and fetch without API keys."""
+    from runner.mcp_protocol import StdioJsonRpcServer
+
+    if service == "brave-search":
+        tools = _build_brave_tools()
+    elif service == "firecrawl":
+        tools = _build_firecrawl_tools()
+    else:
+        tools = []
 
     server = StdioJsonRpcServer(
         server_name=f"epistemic-{service}-fallback",
@@ -86,41 +103,51 @@ def run_zero_key_mcp_server(service: str):
     )
     server.serve_forever()
 
+
+def _launch_brave(npx_bin: Optional[str]) -> None:
+    api_key = get_config_val("BRAVE_SEARCH_API_KEY")
+    if api_key and npx_bin:
+        os.environ["BRAVE_SEARCH_API_KEY"] = api_key
+        os.execvp(npx_bin, [npx_bin, "-y", "@modelcontextprotocol/server-brave-search"])
+    else:
+        run_zero_key_mcp_server("brave-search")
+
+
+def _launch_firecrawl(npx_bin: Optional[str]) -> None:
+    api_key = get_config_val("FIRECRAWL_API_KEY")
+    api_url = get_config_val("FIRECRAWL_API_URL", "https://api.firecrawl.dev")
+    if api_key and npx_bin:
+        os.environ["FIRECRAWL_API_KEY"] = api_key
+        os.environ["FIRECRAWL_API_URL"] = api_url
+        os.execvp(npx_bin, [npx_bin, "-y", "firecrawl-mcp"])
+    else:
+        run_zero_key_mcp_server("firecrawl")
+
+
+def _launch_searxng() -> None:
+    searxng_url = get_config_val("SEARXNG_URL", "http://localhost:8080")
+    searxng_script = os.path.join(SCRIPT_DIR, "searxng_mcp.py")
+    if os.path.exists(searxng_script):
+        os.environ["SEARXNG_URL"] = searxng_url
+        os.execvp("python3", ["python3", searxng_script])
+    else:
+        run_zero_key_mcp_server("searxng")
+
+
 def main():
     service = sys.argv[1] if len(sys.argv) > 1 else "brave-search"
     npx_bin = shutil.which("npx")
 
     if service == "brave-search":
-        api_key = get_config_val("BRAVE_SEARCH_API_KEY")
-        if api_key and npx_bin:
-            os.environ["BRAVE_SEARCH_API_KEY"] = api_key
-            os.execvp(npx_bin, [npx_bin, "-y", "@modelcontextprotocol/server-brave-search"])
-        else:
-            # Fall back to zero-key search proxy
-            run_zero_key_mcp_server("brave-search")
-
+        _launch_brave(npx_bin)
     elif service == "firecrawl":
-        api_key = get_config_val("FIRECRAWL_API_KEY")
-        api_url = get_config_val("FIRECRAWL_API_URL", "https://api.firecrawl.dev")
-        if api_key and npx_bin:
-            os.environ["FIRECRAWL_API_KEY"] = api_key
-            os.environ["FIRECRAWL_API_URL"] = api_url
-            os.execvp(npx_bin, [npx_bin, "-y", "firecrawl-mcp"])
-        else:
-            # Fall back to zero-key readability fetcher + SHA-256 hasher
-            run_zero_key_mcp_server("firecrawl")
-
+        _launch_firecrawl(npx_bin)
     elif service == "searxng":
-        searxng_url = get_config_val("SEARXNG_URL", "http://localhost:8080")
-        searxng_script = os.path.join(SCRIPT_DIR, "searxng_mcp.py")
-        if os.path.exists(searxng_script):
-            os.environ["SEARXNG_URL"] = searxng_url
-            os.execvp("python3", ["python3", searxng_script])
-        else:
-            run_zero_key_mcp_server("searxng")
+        _launch_searxng()
     else:
         sys.stderr.write(f"Unknown service: {service}\n")
         sys.exit(1)
 
+
 if __name__ == "__main__":
     main()

package/extensions/pi/index.js

@@ -12,19 +12,39 @@
  * not a duplicate tool implementation.
  */
 
-import { spawnSync } from 'child_process';
-import path from 'path';
-import { fileURLToPath } from 'url';
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const PKG_ROOT = path.resolve(__dirname, '../..');
 const MCP_SERVER = path.join(PKG_ROOT, 'runner', 'mcp_server.py');
 
+function resolveBinary(name) {
+  const pathDirs = (process.env.PATH || '').split(path.delimiter);
+  for (const dir of pathDirs) {
+    if (!dir || dir === '.' || dir.startsWith('./') || dir.startsWith('../')) continue;
+    const full = path.join(dir, name);
+    try {
+      // Match Node's own PATH search: skip non-files and non-executables so a
+      // directory or a non-executable named `python3` earlier on PATH cannot
+      // shadow the real binary.
+      if (!fs.statSync(full).isFile()) continue;
+      fs.accessSync(full, fs.constants.X_OK);
+      return fs.realpathSync(full);
+    } catch {
+      /* not present, not a file, or not executable — keep searching */
+    }
+  }
+  return name;
+}
+
 /** Uniform dispatch: one-shot MCP call. Returns {ok, text}. */
 function callMcp(tool, args = {}, ctx = {}) {
   const res = spawnSync(
-    'python3',
+    resolveBinary('python3'),
     [MCP_SERVER, 'call', tool, JSON.stringify(args || {})],
     {
       encoding: 'utf-8',
@@ -154,7 +174,7 @@ export default function initPiExtension(pi) {
         ctx.output?.(`💡 [IUMBTEMS Brainstorm] Diverging on: "${objective}"...`);
         // Skill-local context scaffold (not a tool duplicate) -> then canonical tool.
         const scaffold = path.join(PKG_ROOT, 'skills/brainstorming/scripts/brainstorm.py');
-        const pre = spawnSync('python3', [scaffold, '--objective', objective, '--show-context'], {
+        const pre = spawnSync(resolveBinary('python3'), [scaffold, '--objective', objective, '--show-context'], {
           encoding: 'utf-8',
           cwd: ctx.cwd || process.cwd()
         });

package/install.sh

@@ -23,16 +23,16 @@ mkdir -p "$CLAUDE_DIR/skills"
 echo "🔗 Linking skills into $CLAUDE_DIR/skills/..."
 for skill in grilling research_cache epistemic_search swarm_config code_audit oss_scout brainstorming; do
   # legacy research-cache dir name kept as alias for older configs
-  ln -sf "$REPO_DIR/skills/$skill" "$CLAUDE_DIR/skills/$skill"
+  ln -sfn "$REPO_DIR/skills/$skill" "$CLAUDE_DIR/skills/$skill"
   echo "   - $CLAUDE_DIR/skills/$skill -> $REPO_DIR/skills/$skill"
 done
-if [ ! -e "$CLAUDE_DIR/skills/research-cache" ]; then
-  ln -sf "$REPO_DIR/skills/research_cache" "$CLAUDE_DIR/skills/research-cache"
+if [[ ! -e "$CLAUDE_DIR/skills/research-cache" ]]; then
+  ln -sfn "$REPO_DIR/skills/research_cache" "$CLAUDE_DIR/skills/research-cache"
   echo "   - $CLAUDE_DIR/skills/research-cache -> $REPO_DIR/skills/research_cache (legacy alias)"
 fi
 
 # 3. Patch ~/.claude.json mcpServers non-destructively
-if [ -f "$CLAUDE_JSON" ]; then
+if [[ -f "$CLAUDE_JSON" ]]; then
     echo "🔧 Merging research MCP servers into $CLAUDE_JSON..."
     python3 - <<EOF
 import json
@@ -77,7 +77,7 @@ fi
 
 # 4. Patch ~/.claude/settings.json
 SETTINGS_JSON="$CLAUDE_DIR/settings.json"
-if [ -f "$SETTINGS_JSON" ]; then
+if [[ -f "$SETTINGS_JSON" ]]; then
     echo "🔧 Merging plugin settings into $SETTINGS_JSON..."
     python3 - <<EOF
 import json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heretek-ai/epistemic-swarm",
-  "version": "0.4.6",
+  "version": "0.4.8",
   "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.6",
+  "version": "0.4.8",
   "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.6",
+  "version": "0.4.8",
   "description": "IUMBTEMS Epistemic Swarm: dialectic research, code audit, OSS scout, and lateral brainstorming for Gemini CLI.",
   "mcpServers": {
     "brave-search": {