@heretek-ai/epistemic-swarm 0.4.8 → 0.6.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/.agents/skills/factory/SKILL.md

@@ -0,0 +1,13 @@
+# Factory (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/factory/`
+- 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_brainstorm`, `iumbtems_darkharvest`, `iumbtems_socratic_frontier`
+
+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/.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/.omp/commands/domainexpansion.md

@@ -0,0 +1,9 @@
+---
+description: Autonomous agent-guided self-improvement loop (count-flagged)
+---
+
+Run the IUMBTEMS domain-expansion loop for `$1` loops (max 10):
+
+Bypasses per-loop gates; stops on count OR `.factory/STOP` file OR user kill.
+Each loop: agents propose direction, quick swarm check, implement, dual-QA verify.
+Enforce via `python3 skills/factory/scripts/factory.py expansion --run <run> --loops $1`.

package/.omp/commands/factory.md

@@ -0,0 +1,9 @@
+---
+description: Coding-factory Manager loop with grill-gated phased builds
+---
+
+Run the IUMBTEMS coding-factory Manager loop for `$1`:
+
+1. Grill until `.factory/frontier.json` is settled (max 5 swarm cycles per gate); explicit user approve advances each gate.
+2. Per gate: `python3 runner/research_swarm.py --mode brainstorm` plus `--mode darkharvest` (mock-first), then synthesize `.roadmap/<phase>/` GOAL.md + dossier.json.
+3. Programmer subagent per phase; qa-a plus qa-b per phase; retries tracked via `python3 skills/factory/scripts/factory.py` (3 failures escalate).

package/README.md

@@ -146,6 +146,16 @@ 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
+
+# Coding-factory run-state helper (init, phase-add, qa-record, expansion, stop)
+iumbtems factory init --run arena
+iumbtems factory phase-add --run arena --phase 01-handoff --goal "Session handoff" --accept "round-trips;STOP kills loop"
+iumbtems factory expansion --run arena --loops 10
+
+# OpenCode slash commands (also Pi/OMP/Gemini): /factory, /domainexpansion, /darkharvest, /scout, /audit, /grill, /swarm
+
 # Run Socratic grilling and decision frontier calculation
 iumbtems grill --objective "L1 vs L2 state verification trade-offs"
 
@@ -160,6 +170,9 @@ 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.
+- **`/factory`**: Coding-factory Manager loop — grill-gated phased build (manager profile), per-phase programmer spawns, dual QA (3 retries then escalate), explicit sign-off per phase.
+- **`/domainexpansion`**: Autonomous agent-guided self-improvement loop (`/domainexpansion <n>`, max 10); bypasses gates, stops on count OR `.factory/STOP` OR user kill.
 - **`/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

@@ -49,6 +49,8 @@ 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
+  factory <subcommand>  Factory run-state helper (init, phase-add, qa-record, expansion, stop)
   grill                 Launch interactive Socratic decision tree framing
   adapters              Rebuild harness adapter mirrors (skills -> plugins/*, .agents)
   install               Install skills & MCP servers into ~/.claude/
@@ -80,6 +82,8 @@ 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 factory init --run arena && iumbtems factory phase-add --run arena --phase 01-x --goal "..." --accept "a;b"
   iumbtems grill --objective "Rollup architecture trade-offs"
   iumbtems doctor
 `);
@@ -160,6 +164,37 @@ 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 'factory': {
+    // Factory run-state helper: forward subcommands to skills/factory/scripts/factory.py
+    // e.g. iumbtems factory init --run arena
+    //      iumbtems factory qa-record --run arena --phase 01-x --seat qa-a --verdict pass
+    if (args[1] === '--help' || !args[1]) {
+      console.log([
+        'Usage: iumbtems factory <init|phase-add|qa-record|expansion|stop> [options]',
+        '  init --run <name>',
+        '  phase-add --run <name> --phase <id> --goal "<goal>" --accept "a;b"',
+        '  qa-record --run <name> --phase <id> --seat <qa-a|qa-b> --verdict <pass|fail|conditional> [--reason "..."]',
+        '  expansion --run <name> --loops <n> [--max-loops 10]',
+        '  stop --run <name>   (writes .factory/STOP kill-file)',
+      ].join('\n'));
+      break;
+    }
+    runPython('skills/factory/scripts/factory.py', args.slice(1));
+    break;
+  }
+
   case 'grill': {
     runPython('skills/grilling/socratic_tree.py', args.slice(1));
     break;

package/config/opencode-snippet.json

@@ -87,6 +87,104 @@
         "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
+      }
+    },
+    "manager": {
+      "description": "IUMBTEMS Factory Manager: grill-gated phased builds. Owns gates, swarm dispatch, roadmap synthesis, QA tiebreaks. Never writes code.",
+      "mode": "primary",
+      "temperature": 0.2,
+      "permission": {
+        "edit": "deny",
+        "bash": "ask",
+        "task": {
+          "*": "deny",
+          "factory-*": "allow",
+          "programmer": "allow",
+          "qa-a": "allow",
+          "qa-b": "allow",
+          "brainstormer": "allow",
+          "darkharvester": "allow"
+        }
+      },
+      "tools": {
+        "read": true,
+        "write": true,
+        "grep": true,
+        "glob": true,
+        "task": true,
+        "iumbtems_brainstorm": true,
+        "iumbtems_darkharvest": true,
+        "iumbtems_verify_quote": true,
+        "iumbtems_socratic_frontier": true,
+        "iumbtems_config": true
+      }
+    },
+    "programmer": {
+      "description": "IUMBTEMS Factory Programmer: implements exactly one phase brief per spawn. Cites phase evidence hashes. Never invokes swarms or other programmers.",
+      "mode": "subagent",
+      "temperature": 0.3,
+      "permission": {
+        "edit": "allow",
+        "bash": "ask",
+        "task": {
+          "*": "deny"
+        }
+      },
+      "tools": {
+        "read": true,
+        "write": true,
+        "bash": true,
+        "grep": true,
+        "glob": true,
+        "iumbtems_verify_quote": true
+      }
+    },
+    "qa-a": {
+      "description": "IUMBTEMS Factory QA (functional): verifies phase acceptance criteria pass on the real surface. Read-only plus test execution. Diverged prompt from qa-b.",
+      "mode": "subagent",
+      "temperature": 0.1,
+      "permission": {
+        "edit": "deny",
+        "bash": "ask",
+        "task": {
+          "*": "deny"
+        }
+      },
+      "tools": {
+        "read": true,
+        "bash": true,
+        "grep": true,
+        "glob": true
+      }
+    },
+    "qa-b": {
+      "description": "IUMBTEMS Factory QA (adversarial): hunts edge cases, regressions, and acceptance loopholes the functional pass missed. Read-only plus test execution. Diverged prompt from qa-a.",
+      "mode": "subagent",
+      "temperature": 0.4,
+      "permission": {
+        "edit": "deny",
+        "bash": "ask",
+        "task": {
+          "*": "deny"
+        }
+      },
+      "tools": {
+        "read": true,
+        "bash": true,
+        "grep": true,
+        "glob": true
+      }
     }
   },
   "skills": {
@@ -97,7 +195,9 @@
       "./skills/swarm_config",
       "./skills/code_audit",
       "./skills/oss_scout",
-      "./skills/brainstorming"
+      "./skills/brainstorming",
+      "./skills/darkharvest",
+      "./skills/factory"
     ]
   }
 }

package/extensions/pi/index.js

@@ -202,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)
@@ -233,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 }
         }
@@ -264,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heretek-ai/epistemic-swarm",
-  "version": "0.4.8",
+  "version": "0.6.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,9 @@
       "./skills/swarm_config",
       "./skills/code_audit",
       "./skills/oss_scout",
-      "./skills/brainstorming"
+      "./skills/brainstorming",
+      "./skills/darkharvest",
+      "./skills/factory"
     ],
     "prompts": [
       "./prompts/*.md"
@@ -96,7 +98,9 @@
       "./skills/swarm_config",
       "./skills/code_audit",
       "./skills/oss_scout",
-      "./skills/brainstorming"
+      "./skills/brainstorming",
+      "./skills/darkharvest",
+      "./skills/factory"
     ],
     "prompts": [
       "./prompts/*.md"

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/antigravity/skills/factory/SKILL.md

@@ -0,0 +1,13 @@
+# Factory (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/factory/`
+- 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_brainstorm`, `iumbtems_darkharvest`, `iumbtems_socratic_frontier`
+
+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/codex/skills/factory/SKILL.md

@@ -0,0 +1,13 @@
+# Factory (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/factory/`
+- 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_brainstorm`, `iumbtems_darkharvest`, `iumbtems_socratic_frontier`
+
+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/commands/domainexpansion.toml

@@ -0,0 +1,7 @@
+description = "Autonomous agent-guided self-improvement loop (count-flagged)"
+prompt = """Run the IUMBTEMS domain-expansion loop for {{args}} loops (max 10).
+
+Bypasses per-loop gates; stops on count OR .factory/STOP file OR user kill.
+Each loop: agents propose direction, quick swarm check, implement, dual-QA verify.
+Enforce via: python3 skills/factory/scripts/factory.py expansion --run <run> --loops {{args}}.
+"""

package/plugins/gemini/commands/factory.toml

@@ -0,0 +1,8 @@
+description = "Coding-factory Manager loop with grill-gated phased builds"
+prompt = """Run the IUMBTEMS coding-factory Manager loop for: {{args}}.
+
+1. Grill until .factory/frontier.json is settled (max 5 swarm cycles per gate); explicit user approve advances each gate.
+2. Per gate: python3 runner/research_swarm.py --mode brainstorm plus --mode darkharvest (mock-first), then synthesize .roadmap/<phase>/ GOAL.md + dossier.json.
+3. Programmer subagent per phase; qa-a plus qa-b per phase; retries via python3 skills/factory/scripts/factory.py (3 failures escalate).
+Report: .roadmap/ phases plus .factory/state.json.
+"""

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/`.

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

@@ -0,0 +1,13 @@
+# Factory (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/factory/`
+- 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_brainstorm`, `iumbtems_darkharvest`, `iumbtems_socratic_frontier`
+
+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/opencode/index.js

@@ -92,6 +92,7 @@ export const IUMBTEMS_TOOL_NAMES = [
   'iumbtems_code_audit',
   'iumbtems_oss_scout',
   'iumbtems_brainstorm',
+  'iumbtems_darkharvest',
   'iumbtems_verify_quote',
   'iumbtems_socratic_frontier',
   'iumbtems_reindex_claims',
@@ -126,8 +127,8 @@ const TOOL_CATALOG = [
         },
         mode: {
           type: 'string',
-          enum: ['research', 'audit', 'scout', 'hybrid', 'brainstorm'],
-          description: 'Operating mode: research (literature), audit (codebase), scout (OSS), hybrid, brainstorm (lateral ideation)',
+          enum: ['research', 'audit', 'scout', 'hybrid', 'brainstorm', 'darkharvest'],
+          description: 'Operating mode: research (literature), audit (codebase), scout (OSS), hybrid, brainstorm (lateral ideation), darkharvest (competitor teardown)',
         },
         divergence_threshold: {
           type: 'number',
@@ -223,6 +224,39 @@ const TOOL_CATALOG = [
       required: ['objective'],
     },
   },
+  {
+    name: 'iumbtems_darkharvest',
+    description:
+      'Product competitor teardown: seed inspirations plus prompt, expand to adjacents, emit per-feature depend/vendor/clean-room/skip verdicts with SPDX attribution.',
+    input: {
+      type: 'object',
+      properties: {
+        objective: {
+          type: 'string',
+          description: 'Product arena to tear down (e.g. Paseo-class agent harness competitor)',
+        },
+        seeds: {
+          type: 'array',
+          items: { type: 'string' },
+          description: 'Seed inspiration repo URLs',
+        },
+        maxRepos: {
+          type: 'integer',
+          description: 'Cap on total competitors (default 10)',
+        },
+        depth: {
+          type: 'integer',
+          description: 'Dialectic depth 1-4',
+        },
+        mock_mode: {
+          type: 'boolean',
+          description: 'Run in mock mode without invoking LLM tokens',
+          default: false,
+        },
+      },
+      required: ['objective'],
+    },
+  },
   {
     name: 'iumbtems_verify_quote',
     description:
@@ -465,6 +499,50 @@ export const OPENCODE_COMMANDS = [
       'Execute iumbtems_brainstorm with {"objective": "<prompt>"} and report feature vectors, paradigm inversions, and falsifiable spikes.',
     ].join('\n'),
   },
+  {
+    name: 'darkharvest',
+    description: 'Product competitor teardown with per-feature harvest verdicts',
+    usage: '/darkharvest <objective> [--seeds <urls>] [--max-repos <n>]',
+    template: [
+      'Run a product competitor teardown (seed inspirations plus prompt, expand to adjacents).',
+      'Objective: $ARGUMENTS (product arena; seeds may be embedded as URLs)',
+      'If $ARGUMENTS is empty, ask the user for the product arena and seed URLs first; never call the tool with placeholder arguments.',
+      '1. Execute iumbtems_darkharvest with {"objective": "<objective>", "seeds": ["<url>", "..."]} (pass "mock_mode": true only for dry runs).',
+      '2. Report the competitor x capability matrix, white-space gaps both ways, and the SPDX-attributed harvest backlog in .research/darkharvest_report.md.',
+      '3. Legal rule: permissive-only vendor; GPL/AGPL clean-room-rebuild only; workflows clonable, assets never.',
+    ].join('\n'),
+  },
+  {
+    name: 'factory',
+    description: 'Coding-factory Manager loop: grill-gated phased build with programmer spawns and dual QA',
+    usage: '/factory <product-arena>',
+    agent: 'manager',
+    subtask: false,
+    template: [
+      'Run the IUMBTEMS coding-factory Manager loop as the manager agent.',
+      'Arena: $ARGUMENTS',
+      'If $ARGUMENTS is empty, ask the user what to build first; never proceed on placeholder input.',
+      '1. Grill the user until .factory/frontier.json is settled (max 5 brainstorm+darkharvest swarm cycles per gate); explicit user approve advances each gate.',
+      '2. Per gate run iumbtems_brainstorm and iumbtems_darkharvest (mock_mode only for dry runs), then synthesize .roadmap/<phase>/ GOAL.md + dossier.json (goal/evidence/acceptance/brief/verdict/hashes; every claim needs a VERIFIED hash).',
+      '3. Spawn the programmer subagent per phase with the phase dossier (cite phase hashes); run qa-a and qa-b (diverged prompts) per phase; track retries with skills/factory/scripts/factory.py (3 failures escalate to manager).',
+      '4. Manager tiebreaks QA disagreements; explicit user sign-off closes each phase.',
+    ].join('\n'),
+  },
+  {
+    name: 'domainexpansion',
+    description: 'Autonomous agent-guided self-improvement loop over the codebase (count-flagged)',
+    usage: '/domainexpansion <n>',
+    agent: 'manager',
+    subtask: false,
+    template: [
+      'Run the IUMBTEMS domain-expansion loop as the manager agent.',
+      'Loops: $ARGUMENTS (integer count, max 10)',
+      'If $ARGUMENTS is not a positive integer, ask the user for the loop count first.',
+      '1. Bypass per-loop gates; stop on count OR .factory/STOP file OR user kill, whichever first (enforce via skills/factory/scripts/factory.py expansion).',
+      '2. Each loop: agents propose direction, quick iumbtems_brainstorm/iumbtems_darkharvest check, implement via programmer spawn, dual-QA verify.',
+      '3. All expansion proposals carry the strict VERIFIED evidence bar; log every loop to .factory/state.json.',
+    ].join('\n'),
+  },
 ];
 
 /**
@@ -480,6 +558,8 @@ export function commandCatalog() {
   for (const cmd of OPENCODE_COMMANDS) {
     if (!cmd?.name) continue;
     out[cmd.name] = { description: cmd.description, template: cmd.template };
+    if (cmd.agent) out[cmd.name].agent = cmd.agent;
+    if (cmd.subtask !== undefined) out[cmd.name].subtask = cmd.subtask;
   }
   return out;
 }
@@ -738,6 +818,8 @@ async function registerHostCommands(host) {
       draft.add({
         name: cmd.name,
         description: cmd.description,
+        ...(cmd.agent ? { agent: cmd.agent } : {}),
+        ...(cmd.subtask !== undefined ? { subtask: cmd.subtask } : {}),
         execute: async (input) => {
           const args = input?.prompt?.text || '';
           const prompt = (typeof input?.prompt === 'object' && input?.prompt !== null) ? input.prompt : {};