@heretek-ai/epistemic-swarm 0.4.7 → 0.5.0

package/.agents/skills/darkharvest/SKILL.md

@@ -0,0 +1,13 @@
+# Darkharvest (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/darkharvest/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_darkharvest`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "epistemic-swarm",
-  "version": "0.4.7",
+  "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/.omp/commands/darkharvest.md

@@ -0,0 +1,11 @@
+---
+description: Product competitor teardown with per-feature harvest verdicts
+---
+
+Run a product competitor teardown for `$1`:
+
+`python3 runner/research_swarm.py --mode darkharvest --objective "$1"`
+
+Seeds may be embedded as repo URLs; cap live runs at `--max-repos 6`.
+Permissive-only vendor; GPL/AGPL clean-room-rebuild only; workflows clonable, assets never.
+Report: `.research/darkharvest_report.md` (matrix + white-space gaps + SPDX backlog).

package/README.md

@@ -146,6 +146,9 @@ iumbtems run "Sub-millisecond ZK state updates on L1 rollups"
 # Run lateral brainstorming (divergent what-if ideation, never bug fixes)
 iumbtems brainstorm "Where do we go from here?"
 
+# Product competitor teardown with per-feature harvest verdicts
+iumbtems darkharvest "Paseo-class agent harness competitor" --seeds https://github.com/a/b,https://github.com/c/d --max-repos 6 --mock-claude
+
 # Run Socratic grilling and decision frontier calculation
 iumbtems grill --objective "L1 vs L2 state verification trade-offs"
 
@@ -160,6 +163,7 @@ iumbtems test
 - **`/swarm-config`**: Interactive tuning of search engines (DuckDuckGo, Brave, Firecrawl, SearXNG), iteration depth, divergence thresholds, and operating modes.
 - **`/code-audit`**: Dialectic codebase review pairing a Structural Architect (thesis) with a Vulnerability Red-Teamer (antithesis) enforcing line-number proofs (`file:///path#L10-25`).
 - **`/oss-scout`**: Evaluates GitHub repositories, package ecosystems (npm, crates.io, PyPI), license contamination (GPL/AGPL copyleft vs MIT/Apache), and outputs clean-room re-implementation blueprints.
+- **`/darkharvest`**: Product competitor teardown (seed inspirations + prompt, expand to adjacents). Competitor × capability matrix, both-ways white-space gaps, per-feature `depend|vendor|clean-room-rebuild|skip` verdicts with SPDX attribution. Permissive-only vendoring; GPL/AGPL spec-rebuild only.
 - **`/grilling`**: Socratic assumption-inversion and Matt Pocock-style design tree frontier discovery.
 - **`epistemic_search`**: Zero-key DuckDuckGo Lite search and content-addressed fetch with automatic SHA-256 caching.
 

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);
@@ -30,6 +49,7 @@ Commands:
   scout "<feature>"     Scout open-source software, libraries & clean-room blueprints
   run "<objective>"     Run the dialectic multi-agent research swarm
   brainstorm "<prompt>"  Run lateral brainstorming (feature vectors + spikes)
+  darkharvest "<arena>"  Product competitor teardown with harvest verdicts
   grill                 Launch interactive Socratic decision tree framing
   adapters              Rebuild harness adapter mirrors (skills -> plugins/*, .agents)
   install               Install skills & MCP servers into ~/.claude/
@@ -61,6 +81,7 @@ Examples:
   iumbtems scout "Zero-dependency Raft consensus in Rust"
   iumbtems run "Verify sub-millisecond ZK prover latency"
   iumbtems brainstorm "Where do we go from here?"
+  iumbtems darkharvest "Paseo-class agent harness competitor" --seeds https://github.com/a/b,https://github.com/c/d --max-repos 6 --mock-claude
   iumbtems grill --objective "Rollup architecture trade-offs"
   iumbtems doctor
 `);
@@ -74,7 +95,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 +105,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()
   });
@@ -141,6 +162,18 @@ switch (command) {
     break;
   }
 
+  case 'darkharvest': {
+    const objective = args[1];
+    if (!objective || objective.startsWith('--')) {
+      console.error('Error: Please provide a product arena to tear down.');
+      console.error('Example: npx @heretek-ai/epistemic-swarm darkharvest "Paseo-class harness" --seeds https://github.com/a/b --max-repos 6');
+      process.exit(1);
+    }
+    const forwardArgs = ['--mode', 'darkharvest', '--objective', objective, ...args.slice(2)];
+    runPython('runner/research_swarm.py', forwardArgs);
+    break;
+  }
+
   case 'grill': {
     runPython('skills/grilling/socratic_tree.py', args.slice(1));
     break;
@@ -186,18 +219,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/config/opencode-snippet.json

@@ -87,6 +87,18 @@
         "iumbtems_brainstorm": true,
         "iumbtems_config": true
       }
+    },
+    "darkharvester": {
+      "description": "IUMBTEMS Competitor Teardown: seed plus expand, product plus code matrix, per-feature harvest verdicts with SPDX attribution.",
+      "tools": {
+        "read": true,
+        "write": true,
+        "grep": true,
+        "glob": true,
+        "iumbtems_darkharvest": true,
+        "iumbtems_verify_quote": true,
+        "iumbtems_config": true
+      }
     }
   },
   "skills": {
@@ -97,7 +109,8 @@
       "./skills/swarm_config",
       "./skills/code_audit",
       "./skills/oss_scout",
-      "./skills/brainstorming"
+      "./skills/brainstorming",
+      "./skills/darkharvest"
     ]
   }
 }

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()
         });
@@ -182,6 +202,27 @@ export default function initPiExtension(pi) {
         }
       });
     } catch { /* alias is best-effort across pi/omp versions */ }
+
+    // /darkharvest: Product competitor teardown with harvest verdicts
+    pi.registerCommand('darkharvest', {
+      description: 'Product competitor teardown: seed inspirations, expand to adjacents, emit harvest verdicts',
+      usage: '/darkharvest <product-arena> [--seeds <urls>]',
+      handler: async (args, ctx) => {
+        const objective = args.trim();
+        if (!objective) {
+          ctx.output?.('⚠️ Please provide a product arena. Example: /darkharvest "Paseo-class agent harness" --seeds https://github.com/a/b');
+          return;
+        }
+        ctx.output?.(`🌑 [IUMBTEMS Darkharvest] Tearing down: "${objective}"...`);
+        const r = callMcp('iumbtems_darkharvest', { objective }, ctx);
+        if (r.ok) {
+          ctx.output?.(r.text);
+          ctx.output?.('\n✅ Darkharvest complete! Matrix written to .research/darkharvest_report.md');
+        } else {
+          ctx.output?.(`❌ Darkharvest failed:\n${r.text}`);
+        }
+      }
+    });
   }
 
   // 2. Register Agent Tools (thin forwarders)
@@ -213,7 +254,7 @@ export default function initPiExtension(pi) {
         properties: {
           search_engine: { type: 'string', enum: ['duckduckgo', 'brave', 'firecrawl', 'searxng'] },
           max_iterations: { type: 'integer', minimum: 1, maximum: 4 },
-          mode: { type: 'string', enum: ['research', 'audit', 'scout', 'hybrid', 'brainstorm'] },
+          mode: { type: 'string', enum: ['research', 'audit', 'scout', 'hybrid', 'brainstorm', 'darkharvest'] },
           divergence_threshold: { type: 'number', minimum: 0, maximum: 1 },
           show: { type: 'boolean', default: false }
         }
@@ -244,6 +285,31 @@ export default function initPiExtension(pi) {
         return { content: [{ type: 'text', text: r.text }] };
       }
     });
+
+    // Tool: iumbtems_darkharvest (competitor teardown)
+    pi.registerTool({
+      name: 'iumbtems_darkharvest',
+      description: 'Product competitor teardown with per-feature harvest verdicts and SPDX attribution',
+      parameters: {
+        type: 'object',
+        properties: {
+          objective: { type: 'string', description: 'Product arena to tear down' },
+          seeds: { type: 'array', items: { type: 'string' }, description: 'Seed inspiration repo URLs' },
+          maxRepos: { type: 'integer', description: 'Cap on total competitors', default: 10 },
+          mock_mode: { type: 'boolean', description: 'Mock mode without LLM tokens', default: false }
+        },
+        required: ['objective']
+      },
+      execute: async (args = {}) => {
+        const r = callMcp('iumbtems_darkharvest', {
+          objective: args.objective,
+          seeds: args.seeds,
+          maxRepos: args.maxRepos,
+          mock_claude: Boolean(args.mock_mode)
+        }, {});
+        return { content: [{ type: 'text', text: r.text }] };
+      }
+    });
   }
 }
 

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.7",
+  "version": "0.5.0",
   "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": {
@@ -79,7 +79,8 @@
       "./skills/swarm_config",
       "./skills/code_audit",
       "./skills/oss_scout",
-      "./skills/brainstorming"
+      "./skills/brainstorming",
+      "./skills/darkharvest"
     ],
     "prompts": [
       "./prompts/*.md"
@@ -96,7 +97,8 @@
       "./skills/swarm_config",
       "./skills/code_audit",
       "./skills/oss_scout",
-      "./skills/brainstorming"
+      "./skills/brainstorming",
+      "./skills/darkharvest"
     ],
     "prompts": [
       "./prompts/*.md"

package/plugins/antigravity/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://antigravity.google/schemas/v1/plugin.json",
   "name": "epistemic-swarm",
-  "version": "0.4.7",
+  "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/antigravity/skills/darkharvest/SKILL.md

@@ -0,0 +1,13 @@
+# Darkharvest (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/darkharvest/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_darkharvest`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/codex/skills/darkharvest/SKILL.md

@@ -0,0 +1,13 @@
+# Darkharvest (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/darkharvest/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_darkharvest`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/gemini/commands/darkharvest.toml

@@ -0,0 +1,8 @@
+description = "Product competitor teardown with per-feature harvest verdicts"
+prompt = """Run a product competitor teardown for: {{args}}.
+
+Execute: python3 runner/research_swarm.py --mode darkharvest --objective "{{args}}"
+Seeds may be embedded as repo URLs in the objective; cap at --max-repos 6 live.
+Legal rule: permissive-only vendor; GPL/AGPL clean-room-rebuild only; workflows clonable, assets never.
+Report: .research/darkharvest_report.md (competitor x capability matrix + harvest backlog + SPDX blocks).
+"""

package/plugins/gemini/gemini-extension.json

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

package/plugins/gemini/skills/darkharvest/SKILL.md

@@ -0,0 +1,13 @@
+# Darkharvest (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/darkharvest/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_darkharvest`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.