@heretek-ai/epistemic-swarm 0.1.0 → 0.2.2

package/.claude-plugin/marketplace.json

@@ -1,14 +1,41 @@
 {
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
   "name": "heretek-official",
-  "owner": "Heretek AI",
-  "description": "Official plugins and agent harnesses from Heretek AI",
-  "plugins": {
-    "epistemic-swarm": {
-      "source": {
-        "source": "github",
-        "repo": "Heretek-AI/IUMBTEMS"
+  "description": "Official high-integrity research agents and epistemic skills from Heretek AI",
+  "owner": {
+    "name": "Heretek AI",
+    "email": "dev@heretek.ai"
+  },
+  "plugins": [
+    {
+      "name": "epistemic-swarm",
+      "description": "High-Integrity Dialectic Research Agent Harness enforcing verified empirical evidence over parametric hallucination.",
+      "author": {
+        "name": "Heretek AI"
       },
-      "description": "High-Integrity Dialectic Research Agent Harness for Claude Code"
+      "category": "research",
+      "source": "./",
+      "homepage": "https://github.com/Heretek-AI/IUMBTEMS"
+    },
+    {
+      "name": "socratic-grilling",
+      "description": "Matt Pocock-style Socratic interrogation, premise inversion, and lateral exploration skill for Claude Code.",
+      "author": {
+        "name": "Heretek AI"
+      },
+      "category": "agents",
+      "source": "./plugins/socratic-grilling",
+      "homepage": "https://github.com/Heretek-AI/IUMBTEMS"
+    },
+    {
+      "name": "research-cache",
+      "description": "Content-addressed SHA256 Markdown source hashing and verbatim quote verification engine.",
+      "author": {
+        "name": "Heretek AI"
+      },
+      "category": "research",
+      "source": "./plugins/research-cache",
+      "homepage": "https://github.com/Heretek-AI/IUMBTEMS"
     }
-  }
+  ]
 }

package/.claude-plugin/plugin.json

@@ -1,58 +1,64 @@
 {
   "name": "epistemic-swarm",
-  "version": "0.1.0",
+  "version": "0.2.2",
   "description": "High-Integrity Dialectic Research Agent Harness for Claude Code enforcing empirical evidence over parametric hallucination.",
-  "author": "Heretek AI",
+  "author": {
+    "name": "Heretek AI",
+    "email": "dev@heretek.ai"
+  },
   "license": "Apache-2.0",
   "repository": "https://github.com/Heretek-AI/IUMBTEMS",
+  "homepage": "https://github.com/Heretek-AI/IUMBTEMS#readme",
+  "userConfig": {
+    "brave_api_key": {
+      "type": "string",
+      "title": "Brave Search API Key",
+      "description": "API key for Brave Search discovery (optional; zero-key DuckDuckGo fallback is used when unset)",
+      "sensitive": true,
+      "required": false
+    },
+    "firecrawl_api_key": {
+      "type": "string",
+      "title": "Firecrawl API Key",
+      "description": "API key for Firecrawl deep web extraction (optional; zero-key readability fallback is used when unset)",
+      "sensitive": true,
+      "required": false
+    },
+    "firecrawl_api_url": {
+      "type": "string",
+      "title": "Firecrawl API URL",
+      "description": "Endpoint for Firecrawl API or self-hosted instance",
+      "default": "https://api.firecrawl.dev",
+      "required": false
+    },
+    "searxng_url": {
+      "type": "string",
+      "title": "SearXNG URL",
+      "description": "Endpoint for self-hosted SearXNG metasearch instance",
+      "default": "http://localhost:8080",
+      "required": false
+    }
+  },
   "mcpServers": {
     "brave-search": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
-      "env": {
-        "BRAVE_SEARCH_API_KEY": "${BRAVE_SEARCH_API_KEY}"
-      }
+      "command": "python3",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/config/mcp_launcher.py", "brave-search"]
     },
     "firecrawl": {
-      "command": "npx",
-      "args": ["-y", "firecrawl-mcp"],
-      "env": {
-        "FIRECRAWL_API_KEY": "${FIRECRAWL_API_KEY}",
-        "FIRECRAWL_API_URL": "${FIRECRAWL_API_URL:-http://localhost:3002}"
-      }
+      "command": "python3",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/config/mcp_launcher.py", "firecrawl"]
     },
     "searxng": {
       "command": "python3",
-      "args": ["${PLUGIN_DIR}/config/searxng_mcp.py"],
-      "env": {
-        "SEARXNG_URL": "${SEARXNG_URL:-http://localhost:8080}"
-      }
+      "args": ["${CLAUDE_PLUGIN_ROOT}/config/mcp_launcher.py", "searxng"]
     }
   },
   "skills": [
     "./skills/grilling",
-    "./skills/research-cache"
-  ],
-  "configuration": {
-    "SEARXNG_URL": {
-      "type": "string",
-      "description": "SearXNG metasearch instance URL",
-      "default": "http://localhost:8080"
-    },
-    "FIRECRAWL_API_URL": {
-      "type": "string",
-      "description": "Firecrawl API endpoint for JS/Markdown extraction",
-      "default": "http://localhost:3002"
-    },
-    "FIRECRAWL_API_KEY": {
-      "type": "string",
-      "description": "Firecrawl API Key (optional for self-hosted instances)",
-      "default": ""
-    },
-    "BRAVE_SEARCH_API_KEY": {
-      "type": "string",
-      "description": "Brave Search API Key for discovery",
-      "default": ""
-    }
-  }
+    "./skills/research_cache",
+    "./skills/epistemic_search",
+    "./skills/swarm_config",
+    "./skills/code_audit",
+    "./skills/oss_scout"
+  ]
 }

package/MARKETPLACE.md

@@ -0,0 +1,93 @@
+# Heretek AI Claude Code Marketplace 🏪
+
+Official marketplace catalog for Claude Code plugins, skills, and autonomous agent harnesses developed by [Heretek AI](https://github.com/Heretek-AI).
+
+[![Claude Code Compatible](https://img.shields.io/badge/Claude_Code-2.1+-blue.svg)](https://claude.com)
+[![Marketplace Validated](https://img.shields.io/badge/Marketplace-Validated_Strict-success.svg)](https://github.com/Heretek-AI/IUMBTEMS/actions/workflows/validate-marketplace.yml)
+[![npm version](https://img.shields.io/npm/v/@heretek-ai/epistemic-swarm.svg)](https://www.npmjs.com/package/@heretek-ai/epistemic-swarm)
+
+---
+
+## 🚀 Quick Start: Adding the Marketplace
+
+To register the **`heretek-official`** marketplace in Claude Code, run:
+
+```bash
+claude plugin marketplace add Heretek-AI/IUMBTEMS
+```
+
+Verify that the marketplace is configured:
+```bash
+claude plugin marketplace list
+```
+
+---
+
+## 📦 Available Plugins
+
+| Plugin Name | Category | Description | Install Command |
+|---|---|---|---|
+| **`epistemic-swarm`** | `research` | **Flagship Swarm Harness**: Multi-agent dialectic research harness pairing Agent Alpha (Thesis) against Agent Beta (Red Team), audited by an Epistemic Auditor with verbatim empirical quote validation. | `claude plugin install epistemic-swarm@heretek-official` |
+| **`socratic-grilling`** | `agents` | **Socratic Ideation**: Matt Pocock-style Socratic interrogation, premise inversion, and lateral exploration skill. | `claude plugin install socratic-grilling@heretek-official` |
+| **`research-cache`** | `research` | **Source Hasher**: Content-addressed SHA256 Markdown source hashing and verbatim quote verification engine. | `claude plugin install research-cache@heretek-official` |
+
+---
+
+## 🛠️ Plugin Details & Component Breakdown
+
+### 1. `epistemic-swarm` (Flagship Harness)
+- **Manifest**: [`.claude-plugin/plugin.json`](file:///.claude-plugin/plugin.json)
+- **Components**:
+  - **Skills**: `skills/grilling`, `skills/research_cache`, `skills/epistemic_search`
+  - **Hooks**: `hooks/hooks.json` (`PreToolUse` hook intercepting ungrounded `WebSearch` and `WebFetch` to enforce verifiable SHA-256 caching)
+  - **Zero-Key Search**: DuckDuckGo Lite search and automated content-addressed document caching out of the box (zero API key required).
+  - **Safe MCP Servers & Accelerators**:
+    - `brave-search`: Optional Brave SERP discovery (falls back smoothly to DuckDuckGo when unconfigured).
+    - `firecrawl`: Optional Firecrawl JS extraction (falls back smoothly to clean readability reader when unconfigured).
+    - `searxng`: Optional self-hosted metasearch instance proxy.
+  - **System Prompts**: Base Epistemic System Override, Agent Alpha, Agent Beta, Epistemic Auditor, Orchestrator.
+- **Install & Configuration**:
+  ```bash
+  claude plugin install epistemic-swarm@heretek-official
+  # Configure optional API keys and endpoints interactively:
+  claude plugin configure epistemic-swarm
+  # Or inside Claude Code interactive session: /plugin configure
+  ```
+
+### 2. `socratic-grilling` (Modular Skill)
+- **Manifest**: [`plugins/socratic-grilling/.claude-plugin/plugin.json`](file:///plugins/socratic-grilling/.claude-plugin/plugin.json)
+- **Components**:
+  - **Skill**: `skills/grilling` (`/grilling` slash command and interactive decision tree).
+- **Install**:
+  ```bash
+  claude plugin install socratic-grilling@heretek-official
+  ```
+
+### 3. `research-cache` (Modular Tool)
+- **Manifest**: [`plugins/research-cache/.claude-plugin/plugin.json`](file:///plugins/research-cache/.claude-plugin/plugin.json)
+- **Components**:
+  - **Skill & Engine**: `skills/research-cache` (Content-addressed SHA256 raw source storage and quote validation).
+- **Install**:
+  ```bash
+  claude plugin install research-cache@heretek-official
+  ```
+
+---
+
+## 🔍 Inspecting Installed Plugins
+
+To view installed plugins and their active components:
+```bash
+claude plugin list
+claude plugin details epistemic-swarm@heretek-official
+```
+
+To update all installed plugins to their latest versions:
+```bash
+claude plugin update epistemic-swarm
+```
+
+To uninstall:
+```bash
+claude plugin uninstall epistemic-swarm
+```

package/README.md

@@ -1,127 +1,170 @@
-# Epistemic Swarm 🌟
+# IUMBTEMS: I Use My Brain To Express My Self 🧠
 
 [![npm version](https://img.shields.io/npm/v/@heretek-ai/epistemic-swarm.svg)](https://www.npmjs.com/package/@heretek-ai/epistemic-swarm)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![CI/CD](https://github.com/Heretek-AI/IUMBTEMS/actions/workflows/publish.yml/badge.svg)](https://github.com/Heretek-AI/IUMBTEMS/actions)
+[![Marketplace Validated](https://github.com/Heretek-AI/IUMBTEMS/actions/workflows/validate-marketplace.yml/badge.svg)](https://github.com/Heretek-AI/IUMBTEMS/actions)
 
-> **High-Integrity Dialectic Research Agent Harness for Claude Code**  
+> **High-Integrity Dialectic Research Agent Harness**  
+> *Universal support for Claude Code, Pi (pi.dev), and OpenCode V2.*  
 > *Enforcing verified empirical evidence over parametric hallucination.*
 
 ---
 
-## 🎯 The Epistemic Mandate
+## 💡 The Philosophy of IUMBTEMS
 
-Current AI research assistants suffer from parametric hallucination, sycophancy, and premature narrative consensus. They invent citations, smooth over technical contradictions, and extrapolate beyond empirical bounds.
+**IUMBTEMS** (**I Use My Brain To Express My Self**) is grounded in a singular design mandate: **Epistemic Sovereignty**.
 
-**Epistemic Swarm** is an autonomous, dialectic research harness built on top of [Claude Code](https://claude.ai/code) (`~/.claude/` and `~/.claude.json`). It enforces **evidentiary primacy** through:
-1. **Mathematical Evidentiary Tags**: Every factual claim is tagged `[VERIFIED: <hash>]`, `[INFERRED: ...]`, `[HYPOTHESIS: ...]`, or `[NEGATIVE_KNOWLEDGE: ...]`.
-2. **Dialectic Swarm Architecture**: Competitively dispatches **Agent Alpha** (The Thesis / Primary Literature Proponent) and **Agent Beta** (The Antithesis / Hostile Red Team / Active Falsifier).
-3. **Content-Addressed Source Caching**: Web pages and papers are hashed to SHA-256 (`.research/sources/<sha256>.md`).
-4. **Algorithmic Epistemic Auditor**: Verifies cited quotes verbatim against the raw source cache, downgrades fabricated claims, scores divergence, and synthesizes the unvarnished empirical truth.
-5. **Socratic Grilling & Divergent Ideation**: Matt Pocock-style design tree traversal that explores assumption inversions and clarifies constraints *before* committing to search queries.
+Modern LLMs suffer from parametric hallucination, sycophancy, and premature narrative consensus. They invent citations, smooth over technical contradictions, and extrapolate beyond empirical bounds.
+
+**IUMBTEMS** restores rigorous empirical grounding by pairing an unconstrained divergent exploration phase (Matt Pocock-style Socratic grilling and assumption inversion) with a multi-agent dialectic swarm:
+1. **Agent Alpha (The Proponent / Thesis)**: Gathers corroborating primary sources, empirical proofs, and implementation benchmarks.
+2. **Agent Beta (The Adversary / Antithesis / Red Team)**: Hunts for counter-arguments, retracted data, methodology flaws, and edge-case failures.
+3. **Epistemic Auditor**: Verifies cited quotes verbatim against content-addressed raw markdown caches (`.research/sources/<sha256>.md`), prunes ungrounded assertions, and scores dialectic divergence.
 
 ---
 
-## 🏗️ System Architecture
-
-```mermaid
-flowchart TD
-    User([Research Objective]) --> Grilling["Phase 1: Socratic Grilling (/grilling)\n(Assumption Inversion & Frontier Resolution)"]
-    Grilling --> SettledFrontier[Settled Problem Frontier & Constraints]
-    SettledFrontier --> Orchestrator["Phase 2: Swarm Orchestrator\n(Scope Decomposition & DAG Planner)"]
-    
-    Orchestrator --> Scope1[Scope 1: Technical Mechanisms]
-    Orchestrator --> Scope2[Scope 2: Scalability & Economics]
-    
-    subgraph DialecticLoop [Parallel Dialectic Execution per Scope]
-        Scope1 --> Alpha["Agent Alpha: The Proponent\n(Empirical Evidence, Primary Literature)"]
-        Scope1 --> Beta["Agent Beta: The Adversary\n(Active Falsification, Red-Teaming)"]
-        
-        Alpha -->|Writes| AlphaDossier[alpha_dossier.json + Cached Sources]
-        Beta -->|Writes| BetaDossier[beta_dossier.json + Cached Sources]
-        
-        AlphaDossier --> Auditor["Phase 3: Epistemic Auditor\n(Verbatim Quote Hash Verification & Divergence Scoring)"]
-        BetaDossier --> Auditor
-        Auditor --> ScopeSynth[Scope Synthesis & Audit Report]
-    end
-    
-    ScopeSynth --> MasterSynth["Phase 4: Master Synthesis (.research/final_synthesis.md)"]
-```
+## 🌐 Universal Multi-Platform Support
 
----
+IUMBTEMS is packaged as a single universal npm package (`@heretek-ai/epistemic-swarm` with `iumbtems` binary) that runs across the three major autonomous agent platforms:
 
-## ⚡ Quickstart
+### 1. Claude Code (Native Marketplace & Overlay)
 
-### Option 1: Run via NPX (Zero Setup)
+#### Native Marketplace (Recommended)
+Add the official Heretek AI marketplace to Claude Code:
 ```bash
-# Execute deep research swarm directly
-npx @heretek-ai/epistemic-swarm run "Evaluate FPGA Poseidon prover latency bounds"
+claude plugin marketplace add Heretek-AI/IUMBTEMS
+```
+Then install either the flagship harness or modular standalone plugins:
+```bash
+# Flagship dialectic research harness:
+claude plugin install epistemic-swarm@heretek-official
 
-# Run Socratic decision tree framing
-npx @heretek-ai/epistemic-swarm grill --objective "L1 vs L2 state verification trade-offs"
+# Or install standalone modular plugins:
+claude plugin install socratic-grilling@heretek-official
+claude plugin install research-cache@heretek-official
 ```
+See [MARKETPLACE.md](MARKETPLACE.md) for full component specifications.
 
-### Option 2: Install into Claude Code Environment
+#### CLI Overlay Installer
+Install skills and MCP servers directly into `~/.claude/` and `~/.claude.json`:
 ```bash
-git clone https://github.com/Heretek-AI/IUMBTEMS.git
-cd IUMBTEMS
+npx @heretek-ai/epistemic-swarm install
+# or from local repo:
 npm run install-local
 ```
-This automatically symlinks the `/grilling` and `/research-cache` skills into `~/.claude/skills/` and configures MCP servers in `~/.claude.json`.
+- Run `/grilling` inside any interactive Claude Code session.
+- Run headless dialectic research:
+  ```bash
+  iumbtems run "Evaluate FPGA Poseidon prover latency bounds"
+  ```
+
+### 2. Pi (`pi.dev`)
+Install directly into Pi via its native package manager:
+```bash
+pi install npm:@heretek-ai/epistemic-swarm
+```
+- Exposes native `/swarm <objective>` and `/grill` slash commands in the Pi interactive terminal.
+- Discovers skills (`skills/grilling`, `skills/research-cache`) and prompts automatically via the `pi` manifest block.
+
+### 3. OpenCode V2 (`opencode.ai`)
+Enable IUMBTEMS in your `~/.config/opencode/opencode.json` or project `opencode.jsonc`:
+```json
+{
+  "plugin": [
+    "@heretek-ai/epistemic-swarm"
+  ]
+}
+```
+OpenCode V2 automatically registers:
+- `iumbtems_swarm_research`: Dispatches dialectic researcher pairs.
+- `iumbtems_verify_quote`: Audits verbatim citations against the SHA-256 source cache.
+- `iumbtems_socratic_frontier`: Advances the Socratic decision tree frontier.
+
+*(See [config/opencode-snippet.json](config/opencode-snippet.json) for custom agent definitions).*
+
+---
+
+## ⚡ CLI Command Reference
+
+```bash
+# Inspect or update active configuration (search engine, depth, mode)
+iumbtems config
+iumbtems config --engine duckduckgo --depth 3 --mode audit
+
+# Run dialectic codebase architecture & security audit
+iumbtems audit "runner/ and skills/ concurrency and injection security"
+
+# Scout open-source software, mature libraries & clean-room blueprints
+iumbtems scout "Zero-dependency Raft consensus implementations in Rust"
+
+# Run the autonomous dialectic research swarm
+iumbtems run "Sub-millisecond ZK state updates on L1 rollups"
+
+# Run Socratic grilling and decision frontier calculation
+iumbtems grill --objective "L1 vs L2 state verification trade-offs"
+
+# Environment diagnostics (Claude Code, Node, Python)
+iumbtems doctor
+
+# Run automated test suite
+iumbtems test
+```
+
+### Specialized Dialectic Skills & Slash Commands
+- **`/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.
+- **`/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.
+
 
 ---
 
 ## 🏷️ Epistemic Tagging Taxonomy
 
-| Tag | Meaning | Requirement |
+Every factual claim in IUMBTEMS carries an explicit evidentiary tag:
+
+| Tag | Formal Definition | Verification Standard |
 | :--- | :--- | :--- |
-| `[VERIFIED: <hash>]` | Direct empirical fact backed by primary source. | Verbatim quote must exist in `.research/sources/<hash>.md`. |
-| `[INFERRED: <reasoning>]` | Deductive conclusion from verified facts. | Must list parent verified claims and deductive step. |
+| `[VERIFIED: <hash>]` | Direct empirical fact from primary source. | Verbatim quote must exist in `.research/sources/<hash>.md`. |
+| `[INFERRED: <reasoning>]` | Deductive conclusion from verified facts. | Explicit list of parent verified premises and bridging logic. |
 | `[HYPOTHESIS: <test>]` | Speculative assertion or projection. | Must define a measurable falsification criterion. |
-| `[NEGATIVE_KNOWLEDGE: <query>]` | Verified absence of empirical evidence. | Records exact search query and confirmed literature gap. |
+| `[NEGATIVE_KNOWLEDGE: <query>]` | Verified absence of empirical evidence. | Records exact search query and literature gap. |
 
 ---
 
 ## 🔍 Multi-Tier OSINT & Search Pipeline
 
-1. **Discovery Tier**: SearXNG (metasearch) and Brave Search API.
+1. **Discovery Tier**: SearXNG (unbiased metasearch) and Brave Search API.
 2. **Extraction Tier**: Firecrawl (headless JavaScript rendering, DOM cleaning, Markdown extraction).
-3. **Academic Tier**: Semantic Scholar / arXiv MCPs for DOI resolution.
+3. **Academic Tier**: Semantic Scholar / arXiv MCPs for DOI citation resolution.
 4. **Caching Tier**: Content-addressed SHA-256 storage (`skills/research-cache/hasher.py`).
 
-### Optional Turnkey Infrastructure (SearXNG + Firecrawl)
-To run your own unbiased metasearch and headless extractor locally:
+### Local Infrastructure (Optional)
+Run local SearXNG and Firecrawl instances via Docker Compose:
 ```bash
 docker compose -f config/docker-compose.infra.yml up -d
 ```
 
 ---
 
-## 🧪 Testing
+## 📦 CI/CD & Trusted Publishing
 
-Epistemic Swarm comes with an automated test suite verifying source hashing, quote substring matching, IPC state transitions, and mock swarm dispatch:
+This package is distributed on npm under `@heretek-ai` with [npm Trusted Publishing (OIDC)](https://docs.npmjs.com/trusted-publishers) and GitHub Actions.
 
+### First-Time CLI Bootstrap
 ```bash
-npm test
+git pull origin main
+npm publish --access public
 ```
 
----
-
-## 📦 Deployment & CI/CD
-
-This package is distributed via npm under `@heretek-ai` with [npm Trusted Publishing (OIDC)](https://docs.npmjs.com/trusted-publishers) and GitHub Actions.
-
-### First-Time Publication (One-Time Bootstrap)
-1. Authenticate locally:
-   ```bash
-   npm login
-   ```
-2. Publish initial version:
-   ```bash
-   npm publish --access public
-   ```
-3. In `npmjs.com/package/@heretek-ai/epistemic-swarm/access`, add **GitHub Actions** as a Trusted Publisher for repository `Heretek-AI/IUMBTEMS` and workflow `.github/workflows/publish.yml`.
-4. Subsequent releases publish automatically upon pushing a GitHub Release or git tag!
+### GitHub Actions OIDC Setup
+1. In `npmjs.com/package/@heretek-ai/epistemic-swarm/access`, add **GitHub Actions** as a Trusted Publisher:
+   - **Repository Owner**: `Heretek-AI`
+   - **Repository Name**: `IUMBTEMS`
+   - **Workflow Pattern**: `.github/workflows/publish.yml`
+2. Future releases publish automatically upon pushing a GitHub Release or version tag (`v*.*.*`)!
 
 ---
 

package/bin/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 /**
- * Epistemic Swarm CLI
- * Multi-agent dialectic research harness for Claude Code.
+ * IUMBTEMS CLI: I Use My Brain To Express My Self
+ * High-Integrity Dialectic Research Harness for Claude Code, Pi, and OpenCode V2.
  */
 
 const { spawnSync } = require('child_process');
@@ -15,30 +15,47 @@ const command = args[0] || 'help';
 
 function printHelp() {
   console.log(`
-🌟 Epistemic Swarm: High-Integrity Research Harness for Claude Code
+🧠 IUMBTEMS: I Use My Brain To Express My Self
+🌟 Epistemic Swarm: High-Integrity Research Harness
+   Platforms: Claude Code | Pi (pi.dev) | OpenCode V2
    Organization: @heretek-ai | Repository: Heretek-AI/IUMBTEMS
 
 Usage:
-  npx @heretek-ai/epistemic-swarm <command> [options]
   iumbtems <command> [options]
+  npx @heretek-ai/epistemic-swarm <command> [options]
 
 Commands:
+  config [options]      Inspect or modify swarm parameters (engine, depth, mode)
+  audit "<target>"      Run dialectic codebase architectural & security audit
+  scout "<feature>"     Scout open-source software, libraries & clean-room blueprints
   run "<objective>"     Run the dialectic multi-agent research swarm
   grill                 Launch interactive Socratic decision tree framing
   install               Install skills & MCP servers into ~/.claude/
+  marketplace           Show Claude Code marketplace catalog & install commands
   test                  Run test suite for hashing, state machine & auditor
-  doctor                Check environment requirements (Claude Code, Python, Node)
+  doctor                Check environment requirements (Claude Code, Pi, OpenCode)
   help                  Show this help message
 
+Platform Extensions:
+  Pi (pi.dev):          pi install npm:@heretek-ai/epistemic-swarm
+  OpenCode V2:          add "@heretek-ai/epistemic-swarm" to opencode.json plugins
+  Claude Code:          npx @heretek-ai/epistemic-swarm install
+
 Options:
   --mock-claude         Run swarm with synthetic mock responses (zero API cost)
   --frontier <file>     Path to settled frontier.json from Socratic grilling
+  --mode <mode>         Operating mode (research, audit, scout, hybrid)
+  --engine <engine>     Search engine (duckduckgo, brave, firecrawl, searxng)
+  --depth <n>           Max dialectic iterations (1-4)
   --dir <path>          Path to .research workspace directory (default: .research)
 
 Examples:
-  npx @heretek-ai/epistemic-swarm run "Verify sub-millisecond ZK prover latency"
-  npx @heretek-ai/epistemic-swarm grill --objective "Rollup architecture trade-offs"
-  npx @heretek-ai/epistemic-swarm install
+  iumbtems config --engine duckduckgo --depth 3
+  iumbtems audit "runner/ and skills/ concurrency & security"
+  iumbtems scout "Zero-dependency Raft consensus in Rust"
+  iumbtems run "Verify sub-millisecond ZK prover latency"
+  iumbtems grill --objective "Rollup architecture trade-offs"
+  iumbtems doctor
 `);
 }
 
@@ -68,6 +85,31 @@ function runBash(scriptRelPath, extraArgs = []) {
 }
 
 switch (command) {
+  case 'config': {
+    runPython('skills/swarm_config/configure.py', args.slice(1));
+    break;
+  }
+
+  case 'audit': {
+    const targetObj = args[1] && !args[1].startsWith('--') ? args[1] : 'Full codebase architectural and security audit';
+    const restArgs = args[1] && !args[1].startsWith('--') ? args.slice(2) : args.slice(1);
+    const forwardArgs = ['--mode', 'audit', '--objective', targetObj, ...restArgs];
+    runPython('runner/research_swarm.py', forwardArgs);
+    break;
+  }
+
+  case 'scout': {
+    const objective = args[1];
+    if (!objective || objective.startsWith('--')) {
+      console.error('Error: Please provide a feature or library to scout.');
+      console.error('Example: npx @heretek-ai/epistemic-swarm scout "Zero-dependency Raft in Rust"');
+      process.exit(1);
+    }
+    const forwardArgs = ['--mode', 'scout', '--objective', objective, ...args.slice(2)];
+    runPython('runner/research_swarm.py', forwardArgs);
+    break;
+  }
+
   case 'run': {
     const objective = args[1];
     if (!objective || objective.startsWith('--')) {
@@ -90,6 +132,29 @@ switch (command) {
     break;
   }
 
+  case 'marketplace': {
+    const mktPath = path.join(PKG_ROOT, '.claude-plugin', 'marketplace.json');
+    if (!fs.existsSync(mktPath)) {
+      console.error('Marketplace manifest not found.');
+      process.exit(1);
+    }
+    const mkt = JSON.parse(fs.readFileSync(mktPath, 'utf8'));
+    console.log(`\n🏪 CLAUDE CODE MARKETPLACE: ${mkt.name.toUpperCase()}`);
+    console.log(`================================================`);
+    console.log(`Owner:       ${mkt.owner ? mkt.owner.name : 'Unknown'} <${mkt.owner ? mkt.owner.email : ''}>`);
+    console.log(`Description: ${mkt.description}\n`);
+    console.log(`🚀 Add this marketplace to Claude Code:`);
+    console.log(`   claude plugin marketplace add Heretek-AI/IUMBTEMS\n`);
+    console.log(`📦 Available Plugins in Marketplace:`);
+    (mkt.plugins || []).forEach((p, idx) => {
+      console.log(`   ${idx + 1}. ${p.name} [${p.category || 'plugin'}]`);
+      console.log(`      Description: ${p.description}`);
+      console.log(`      Install:     claude plugin install ${p.name}@${mkt.name}`);
+      console.log(`      Configure:   claude plugin configure ${p.name}@${mkt.name}\n`);
+    });
+    break;
+  }
+
   case 'test': {
     runPython('-m', ['unittest', 'discover', '-s', 'runner/tests']);
     break;