@heretek-ai/epistemic-swarm 0.7.20 → 0.7.22

package/.claude-plugin/plugin.json

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

package/README.md

@@ -157,7 +157,7 @@ Related environment variables:
 
 Spawned agents inherit `PWD` set to their working directory, so harnesses that resolve their project root from `$PWD` (OpenCode) land in the same tree the runner reads from.
 
-> **Legacy config migration:** configs written before 0.7.6 could pin `agents.<role>.backend = ["claude", "-p"]`, which silently overrode the host-native default. That pin is now migrated to `null` on load (only when the top-level `backend` is not an explicit `"claude"`), and the migration is persisted by `iumbtems config`. To deliberately keep Claude on an OpenCode host, set `"backend": "claude"`.
+> **Legacy config migration:** configs written before 0.7.6 could pin `agents.<role>.backend = ["claude", "-p"]`, which silently overrode the host-native default. That pin is now migrated to `null` on load (only when the top-level `backend` is not an explicit `"claude"`), and the migration is persisted on the next config **write** (a read / `--show` never heals). To deliberately keep Claude on an OpenCode host, set `"backend": "claude"`.
 
 ---
 
@@ -224,7 +224,7 @@ The canonical MCP server (`python3 runner/mcp_server.py`, stdio) exposes these t
 | `iumbtems_oss_scout` | Scout open-source libraries, audit licenses, and build clean-room blueprints. |
 | `iumbtems_brainstorm` | Lateral ideation portfolio: feature vectors, paradigm moves, falsifiable spikes. Never bug fixes. |
 | `iumbtems_darkharvest` | Product competitor teardown with per-feature `depend\|vendor\|clean-room\|skip` verdicts and SPDX attribution. |
-| `iumbtems_factory` | Drive factory run state: `init` / `phase-add` / `qa-record` / `expansion` / `stop`. State in `<project>/.factory` and `.roadmap`. |
+| `iumbtems_factory` | Drive factory run state: `init` / `phase-add` / `qa-record` / `expansion` / `stop` / `gate`. State in `<project>/.factory` and `.roadmap`. |
 | `iumbtems_verify_quote` | Audit a verbatim citation against the SHA-256 source cache (`.research/sources/<hash>.md`). |
 | `iumbtems_socratic_frontier` | Inspect or advance the Socratic decision-tree frontier (`.research/frontier.json`). |
 | `iumbtems_export_brief` | Export a proof-carrying research brief (PCRB): a self-contained signed bundle of synthesis, claims, quote witnesses, and full source texts. |
@@ -265,6 +265,27 @@ Nine canonical skills live in `skills/*/SKILL.md`. Each maps to a slash command
 
 ---
 
+## ⚙️ Settings Surface (`/swarm-config`)
+
+The settings surface is the recommended way to tune the harness from inside OpenCode V2. It has two parts:
+
+- **`/swarm-config` wizard** — a native dialog wizard (`ui.dialog.select/prompt/confirm`) showing every canonical key with a provenance badge (`default` / `file` / `env-override`), one editable row at a time, validated and written atomically on save.
+- **Status panel** — a read-only panel opened from the command palette / keymap (`iumbtems.swarm-settings`) rendering the effective rows with a **next-run** badge. It never writes.
+
+The canonical config it edits is **`.research/config.json`** — the TUI resolves `.research` from the OpenCode host root; `IUMBTEMS_PROJECT_DIR` / `--dir` / `base_dir` select the workspace for the CLI, MCP, and runner surfaces. Configurable values include the search engine, depth (`max_iterations`), operating `mode`, `backend`, per-role (`agents.*`) backend/model, `license_whitelist`, the cache / TTL / search-timeout knobs, `searxng_url`, `verify.min_fuzzy_confidence`, the persistence `mcp_servers` toggle map, `allocation`, `domain_pack`, and the deprecated display-only `output_dir`. (`divergence_threshold` is advisory: recorded, never gating a verdict.)
+
+**Honest boundaries**
+
+- **Values apply to the NEXT swarm run.** The Python runner reads `.research/config.json` once at run start, so a save never hot-swaps a running swarm — the wizard and panel both say "applies to the next swarm run".
+- **Per-role temperature does not govern spawned agents.** The OpenCode session `context` hook honors `IUMBTEMS_TEMPERATURE[_<ROLE>]` for sessions running inside OpenCode, but there is **no verified path** that sets per-role temperature for spawned swarm agents — that leg is recorded `[NEGATIVE_KNOWLEDGE]` (S3, dated 2026-09-29; waiver W3). The UI deliberately makes no temperature claim.
+- **No secrets in config.** API keys stay in the environment (`FIRECRAWL_API_KEY`, …). The surface only reports whether an env override is set for the keys it models; it never renders an env value, and it does not probe engine availability.
+
+Writes prefer the plugin's `iumbtems.settings` RPC (server-side validation + an `expectedHash` lost-update guard; the RPC surfaces a `conflict` error type, and Python's code is `CONFLICTING_EXPECTED_HASH`) and degrade to a direct-fs write with a visible toast when `client.rpc` is absent; `.research/config.json` stays the single source of truth. See [docs/SYSTEM_ARCHITECTURE.md](docs/SYSTEM_ARCHITECTURE.md) §6.7 for the full data flow, the atomic-write + lock protocol, and the `ctx.storage` mirror.
+
+*Reviewed settings-surface patterns from Gemini CLI, Codex, Goose, Aider, Cline, OpenCode, and Crush (docs-only) informed this design; no code was copied.*
+
+---
+
 ## 🗂️ Workspace & Evidence Model
 
 All state lives in a local `.research/` directory (resolved from `IUMBTEMS_PROJECT_DIR` when set, else the process cwd):
@@ -366,7 +387,7 @@ The package is distributed on npm as `@heretek-ai/epistemic-swarm` using [npm Tr
 
 **Release flow** (see [AGENTS.md](AGENTS.md#releases)):
 
-1. Bump `package.json` **and** `.claude-plugin/plugin.json` **and** the lockfile in lockstep.
+1. Bump the **four enforced manifests** in lockstep: `package.json`, `package-lock.json`, `.claude-plugin/plugin.json`, and `plugins/antigravity/plugin.json` (`python3 scripts/build_adapters.py --check` guards the AntiGravity one).
 2. Commit and push to `main`.
 3. `gh release create vX.Y.Z` — the `Publish to npm` workflow
    (`.github/workflows/publish.yml`) runs on `release: published`, executes the

package/bin/cli.js

@@ -50,7 +50,7 @@ Commands:
   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)
+  factory <subcommand>  Factory run-state helper (init, phase-add, qa-record, expansion, stop, gate)
   grill                 Launch interactive Socratic decision tree framing
   adapters              Rebuild harness adapter mirrors (skills -> plugins/*, .agents)
   install               Install skills & MCP servers into ~/.claude/
@@ -183,12 +183,13 @@ switch (command) {
     //      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]',
+        'Usage: iumbtems factory <init|phase-add|qa-record|expansion|stop|gate> [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)',
+        '  gate --run <name> --phase <id> --action <open|settle|approve|waive|escalate|count> [--reason "..."]',
       ].join('\n'));
       break;
     }

package/extensions/pi/index.js

@@ -319,11 +319,12 @@ export default function initPiExtension(pi) {
     // Tool: iumbtems_factory (run-state helper, no script paths)
     pi.registerTool({
       name: 'iumbtems_factory',
-      description: 'Drive factory run state: init / phase-add / qa-record / expansion / stop',
+      description: 'Drive factory run state: init / phase-add / qa-record / expansion / stop / gate',
       parameters: {
         type: 'object',
         properties: {
-          command: { type: 'string', enum: ['init', 'phase-add', 'qa-record', 'expansion', 'stop'] },
+          command: { type: 'string', enum: ['init', 'phase-add', 'qa-record', 'expansion', 'stop', 'gate'] },
+          action: { type: 'string', enum: ['open', 'settle', 'approve', 'waive', 'escalate', 'count'], description: 'Gate action (with command: gate)' },
           run: { type: 'string', description: 'Factory run name' },
           phase: { type: 'string' },
           goal: { type: 'string' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heretek-ai/epistemic-swarm",
-  "version": "0.7.20",
+  "version": "0.7.22",
   "description": "IUMBTEMS (Epistemic Swarm) \u2014 High-Integrity Dialectic Research Agent Harness for Claude Code, OpenCode V2, Pi (pi.dev), 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.7.20",
+  "version": "0.7.22",
   "description": "IUMBTEMS (Epistemic Swarm) \u2014 High-Integrity Dialectic Research, Architecture Auditing, Competitor Teardowns, and Socratic Planning for Antigravity.",
   "author": {
     "name": "Heretek AI",

package/plugins/antigravity/rules/AGENTS.md

@@ -109,9 +109,11 @@ or `[NEGATIVE_KNOWLEDGE: <query>]`. Never present parametric recall as verified.
   effect only after release + reinstall.
 
 ## Releases
-- Bump `package.json` (+ lockfile sync) **and `.claude-plugin/plugin.json`**
-  (0.7.5 shipped with a stale plugin manifest — keep all three in lockstep),
-  commit, push to `main`, then
+- Bump the **four enforced manifests** in lockstep — `package.json`,
+  `package-lock.json`, `.claude-plugin/plugin.json`, and
+  `plugins/antigravity/plugin.json` (0.7.5 shipped a stale plugin manifest and
+  v0.7.18 missed the AntiGravity manifest, failing `Validate All Harnesses` +
+  `Publish to npm` twice). Then commit, push to `main`, then
   `gh release create vX.Y.Z`. The `Publish to npm` workflow (OIDC trusted
   publishing) runs on release-published. Verify with
   `curl https://registry.npmjs.org/@heretek-ai%2Fepistemic-swarm`

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

@@ -21,7 +21,7 @@ npm cache in consuming projects, and relative paths broke live: the manager
 agent ran `find / -name factory.py`). The tool wraps the same helper and
 resolves the project via `project_dir` argument, `IUMBTEMS_PROJECT_DIR`, or
 the session cwd. It supports `init`, `phase-add`, `qa-record`, `expansion`,
-`stop`, and returns `status: escalated` (exit 2) on the 3rd QA failure.
+`stop`, `gate` (`--action open|settle|approve|waive|escalate|count`), and returns `status: escalated` (exit 2) on the 3rd QA failure.
 
 ## 2. Gate protocol (max 5 swarm cycles per gate)