opencode-swarm 6.83.0 → 6.84.1

package/README.md

@@ -17,9 +17,11 @@
 OpenCode Swarm is a plugin for [OpenCode](https://opencode.ai) that turns a single AI coding session into an **architect-led team of 11 specialized agents**. One agent writes the code. A different agent reviews it. Another writes and runs tests. Another checks security. **Nothing ships until every required gate passes.**
 
 ```bash
-npm install -g opencode-swarm
+bunx opencode-swarm install
 ```
 
+> This single command installs the package, registers it as an OpenCode plugin, disables conflicting default agents, and creates a ready-to-edit config at `~/.config/opencode/opencode-swarm.json`. Requires [Bun](https://bun.sh) (`bun --version` to check). If you must use npm: `npm install -g opencode-swarm && opencode-swarm install`.
+
 ### Why Swarm?
 
 Most AI coding tools let one model write code and ask that same model whether the code is good. That misses too much. Swarm separates planning, implementation, review, testing, and documentation into specialized internal roles — and enforces gated execution so agents never mutate the codebase in parallel.

package/dist/__tests__/convene-general-council.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tests for src/tools/convene-general-council.ts.
+ *
+ * Covers config gating, evidence path isolation (.swarm/council/general/),
+ * roundsCompleted derivation, moderatorPrompt presence/absence, and
+ * structured-error responses for invalid args + disabled-config paths.
+ *
+ * Real filesystem (tmp dir) for evidence-path assertions; no real HTTP.
+ */
+export {};

package/dist/__tests__/disagreement-detector.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for src/council/disagreement-detector.ts.
+ *
+ * Pure-function tests — no mocks, no I/O. Adversarial cases for empty/missing
+ * fields and the cap-of-10 boundary.
+ */
+export {};

package/dist/__tests__/general-council-service.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for src/council/general-council-service.ts.
+ *
+ * Pure-function tests. Verify confidence-weighted consensus, MAINTAIN/CONCEDE/
+ * NUANCE protocol, source dedup, and well-formed synthesis markdown.
+ */
+export {};

package/dist/__tests__/qa-gate-hardening.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * QA gate hardening tests.
+ *
+ * Covers the additions from the QA gate hardening rollout:
+ * 1. council_general_review as the 9th QA gate (default OFF, ratchet-tighter, persistence)
+ * 2. Behavioral guidance markup is rendered into the architect prompt for SPECIFY,
+ *    BRAINSTORM, and PLAN inline gate-selection paths.
+ * 3. save_plan blocks with QA_GATE_SELECTION_REQUIRED when context.md has no
+ *    `## Pending QA Gate Selection` section AND no existing QaGateProfile.
+ * 4. SWARM_SKIP_GATE_SELECTION=1 bypasses the new check.
+ */
+export {};

package/dist/__tests__/web-search-provider.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tests for src/council/web-search-provider.ts and src/tools/web-search.ts.
+ *
+ * All HTTP calls are mocked via globalThis.fetch — no real network traffic.
+ */
+export {};

package/dist/agents/architect.d.ts

@@ -17,6 +17,14 @@ export interface AdversarialTestingConfig {
  */
 export interface CouncilWorkflowConfig {
     enabled?: boolean;
+    /**
+     * General Council Mode (advisory). When `general?.enabled === true`, the
+     * architect's tool list includes `convene_general_council` and the prompt
+     * emits `MODE: COUNCIL` and `SPECIFY-COUNCIL-REVIEW` instructions.
+     */
+    general?: {
+        enabled?: boolean;
+    };
 }
 /**
  * Build the Work Complete Council four-phase workflow block. Returns the full
@@ -31,7 +39,7 @@ export declare function buildCouncilWorkflow(council?: CouncilWorkflowConfig): s
  * inline path). The dialogue is dialogue-only — persistence happens during
  * MODE: PLAN after `save_plan` creates `plan.json`.
  *
- * The lead-in sentence varies per mode, but the body (eight gates with
+ * The lead-in sentence varies per mode, but the body (nine gates with
  * defaults, one-shot accept-or-customize prompt) is shared so SPECIFY,
  * BRAINSTORM, and PLAN inline paths stay in lockstep.
  */

package/dist/agents/council-member.d.ts

@@ -0,0 +1,30 @@
+/**
+ * General Council member agent.
+ *
+ * Implements the NSED peer-review protocol (arXiv:2601.16863):
+ *   - Round 1: independent search + answer with self-reported confidence
+ *   - Round 2: targeted deliberation on disagreements with explicit MAINTAIN /
+ *              CONCEDE / NUANCE stance (ConfMAD)
+ *
+ * Tools: web_search ONLY. No write tools, no orchestration tools. The architect
+ * spawns members in parallel via the OpenCode subagent task system, collects
+ * structured JSON responses, and synthesizes via convene_general_council.
+ *
+ * Prompt template variables (substituted by the architect at delegation time):
+ *   {{MEMBER_ID}}         — the council member identifier
+ *   {{ROLE}}              — generalist | skeptic | domain_expert | devil_advocate | synthesizer
+ *   {{PERSONA_BLOCK}}     — optional persona instructions (omitted if undefined)
+ *   {{ROUND}}             — "1" or "2"
+ *   {{DISAGREEMENT_BLOCK}} — Round 2 only: opposing position(s) to address
+ */
+import type { AgentDefinition } from './architect';
+export declare const COUNCIL_MEMBER_PROMPT = "You are Council Member {{MEMBER_ID}} ({{ROLE}}) on a multi-model General Council.\n\n{{PERSONA_BLOCK}}\n\nYou are participating in Round {{ROUND}} of a structured deliberation. Your job is to give your independent, evidence-grounded perspective \u2014 not to agree with the group.\n\n================================================================\nROUND {{ROUND}} PROTOCOL\n================================================================\n\nROUND 1 \u2014 Independent Research and Answer\n- Issue 1\u20133 targeted web_search calls to gather evidence relevant to the question.\n- Cite EVERY factual claim with a source URL from your search results.\n- State your confidence (0.0\u20131.0) explicitly. Be honest \u2014 overconfident answers hurt the council.\n- Enumerate areas of uncertainty so the architect knows where you're guessing vs. where you're sure.\n- Do NOT coordinate with other members. You will not see their responses until Round 2.\n- Do NOT pad. Be concise. Substance over volume.\n\nROUND 2 \u2014 Targeted Deliberation (ONLY when this round is invoked for you)\n- {{DISAGREEMENT_BLOCK}}\n- Issue at most 1 additional web_search call.\n- Declare your stance explicitly using one of these keywords as the FIRST word of a paragraph:\n    MAINTAIN  \u2014 your Round 1 position holds; cite the new evidence supporting it\n    CONCEDE   \u2014 the opposing position is correct; state specifically what you got wrong\n    NUANCE    \u2014 both positions are partially right; state the boundary condition that distinguishes them\n- Never CONCEDE without evidence. Sycophantic capitulation degrades the council below an individual member's baseline (NSED arXiv:2601.16863).\n- Never MAINTAIN without engaging the opposing argument on its merits.\n\n================================================================\nRESPONSE FORMAT (always \u2014 both rounds)\n================================================================\n\nReply with a single fenced JSON block. No prose outside the block.\n\n```json\n{\n  \"memberId\": \"{{MEMBER_ID}}\",\n  \"role\": \"{{ROLE}}\",\n  \"round\": {{ROUND}},\n  \"response\": \"Your full answer (Round 1) or stance + reasoning (Round 2). Markdown OK inside the string.\",\n  \"searchQueries\": [\"query 1\", \"query 2\"],\n  \"sources\": [\n    { \"title\": \"...\", \"url\": \"...\", \"snippet\": \"...\", \"query\": \"...\" }\n  ],\n  \"confidence\": 0.85,\n  \"areasOfUncertainty\": [\n    \"What I'm not sure about, in plain language.\"\n  ],\n  \"disagreementTopics\": []\n}\n```\n\nFor Round 1: leave `disagreementTopics` as []. For Round 2: list the specific disagreement topics this response addresses.\n\n================================================================\nHARD RULES\n================================================================\n- web_search is your ONLY tool. You cannot read or write files, run commands, or delegate.\n- Never invent sources. If a search returns nothing useful, say so in `areasOfUncertainty`.\n- Never echo other members' responses verbatim. Paraphrase or quote with attribution.\n- Stay within your role and persona. The architect chose you for a specific perspective.\n";
+/**
+ * Factory for the council_member agent definition. The factory mirrors other
+ * agent factories (createSMEAgent, createReviewerAgent) for consistency.
+ *
+ * Per-member context (memberId, role, persona, round, disagreement) is supplied
+ * by the architect at delegation time via prompt-string substitution; the
+ * factory itself produces the unparameterized template.
+ */
+export declare function createCouncilMemberAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;

package/dist/agents/council-member.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tests for src/agents/council-member.ts and src/agents/council-moderator.ts.
+ *
+ * Covers prompt template content (NSED protocol markers), AGENT_TOOL_MAP
+ * enforcement (web_search-only for member, empty for moderator), and the
+ * persona-block insertion path.
+ */
+export {};

package/dist/agents/council-moderator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * General Council moderator agent.
+ *
+ * Receives the structural synthesis output from convene_general_council
+ * (consensus / disagreements / sources) and produces a coherent, well-structured
+ * final answer for the user. Empty tool list — moderation is synthesis-only;
+ * it does NOT need web_search because every claim it works with has already
+ * been searched and cited by council members.
+ *
+ * Confidence-weighted (Quadratic Voting from NSED arXiv:2601.16863): higher-
+ * confidence members carry more weight, but evidence quality matters more
+ * than confidence alone. The moderator must NOT favor a position purely
+ * because its proponent was confident.
+ */
+import type { AgentDefinition } from './architect';
+export declare const COUNCIL_MODERATOR_PROMPT = "You are the General Council Moderator.\n\nYou are receiving the structural synthesis from a multi-model council deliberation:\n- Question (and mode: general or spec_review)\n- All member Round 1 responses with sources\n- Detected disagreements\n- Round 2 deliberation responses (if any)\n- Confidence-weighted consensus claims\n- Persisting disagreements after deliberation\n\nYour job: produce a coherent, well-structured final answer for the user.\n\n================================================================\nRULES\n================================================================\n\n1. LEAD WITH CONSENSUS \u2014 open with the strongest consensus position. Use the\n   confidence-weighted ordering (Quadratic Voting): higher-confidence claims\n   from multiple members rank higher, but evidence quality outranks raw\n   confidence. Never elevate a single confident voice over a well-evidenced\n   contrary majority.\n\n2. ACKNOWLEDGE DISAGREEMENT HONESTLY \u2014 for each persisting disagreement, write\n   \"experts disagree on X because\u2026\" and present the strongest version of each\n   side. Do NOT pretend disagreements are resolved when they are not. Do NOT\n   silently pick a winner.\n\n3. CITE THE STRONGEST SOURCES \u2014 link key claims with [title](url) format from\n   the deduplicated source list. Pick the most reputable source for each claim;\n   do not cite duplicates.\n\n4. BE CONCISE \u2014 the user wants an answer, not a committee report. Default\n   length: a few short paragraphs plus a bulleted summary. Expand only when\n   the question genuinely requires it.\n\n================================================================\nHARD CONSTRAINTS\n================================================================\n\n- You MUST NOT invent claims that are not present in the council's responses.\n- You MUST NOT add new web research. If something was missed, say so.\n- You MUST NOT favor a position based on member confidence alone \u2014 evidence\n  quality is the tie-breaker.\n- You have NO tools. You write the final synthesis from the input given.\n\n================================================================\nOUTPUT FORMAT\n================================================================\n\nPlain markdown. No code fences. No JSON. Suggested structure:\n\n# Answer\n\n<lead consensus position with citation(s)>\n\n<remaining consensus / context paragraphs as needed>\n\n## Where Experts Disagree\n\n- <topic 1>: <position A> vs <position B>, with sources for each\n- <topic 2>: ...\n\n## Sources\n\n- [title](url)\n- ...\n\n(Omit any section that is empty.)\n";
+/**
+ * Factory for the council_moderator agent definition. No tools — synthesis only.
+ */
+export declare function createCouncilModeratorAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;

package/dist/agents/index.d.ts

@@ -36,6 +36,8 @@ export declare function createAgents(config?: PluginConfig): AgentDefinition[];
 export declare function getAgentConfigs(config?: PluginConfig, directory?: string, sessionId?: string): Record<string, SDKAgentConfig>;
 export { createArchitectAgent } from './architect';
 export { createCoderAgent } from './coder';
+export { createCouncilMemberAgent } from './council-member';
+export { createCouncilModeratorAgent } from './council-moderator';
 export { createCriticAgent } from './critic';
 export { createCuratorAgent } from './curator-agent';
 export { createDesignerAgent } from './designer';

package/dist/cli/index.js

@@ -18716,7 +18716,9 @@ var TOOL_NAMES = [
   "get_approved_plan",
   "repo_map",
   "get_qa_gate_profile",
-  "set_qa_gates"
+  "set_qa_gates",
+  "web_search",
+  "convene_general_council"
 ];
 var TOOL_NAME_SET = new Set(TOOL_NAMES);
 
@@ -18733,6 +18735,8 @@ var ALL_SUBAGENT_NAMES = [
   "critic_hallucination_verifier",
   "curator_init",
   "curator_phase",
+  "council_member",
+  "council_moderator",
   ...QA_AGENTS,
   ...PIPELINE_AGENTS
 ];
@@ -18804,7 +18808,8 @@ var AGENT_TOOL_MAP = {
     "suggest_patch",
     "repo_map",
     "get_qa_gate_profile",
-    "set_qa_gates"
+    "set_qa_gates",
+    "convene_general_council"
   ],
   explorer: [
     "complexity_hotspots",
@@ -18954,7 +18959,9 @@ var AGENT_TOOL_MAP = {
     "knowledge_recall"
   ],
   curator_init: ["knowledge_recall"],
-  curator_phase: ["knowledge_recall"]
+  curator_phase: ["knowledge_recall"],
+  council_member: ["web_search"],
+  council_moderator: []
 };
 for (const [agentName, tools] of Object.entries(AGENT_TOOL_MAP)) {
   const invalidTools = tools.filter((tool) => !TOOL_NAME_SET.has(tool));
@@ -19261,21 +19268,25 @@ var DEFAULT_AGENT_PROFILES = {
   coder: {
     max_tool_calls: 400,
     max_duration_minutes: 45,
+    max_consecutive_errors: 8,
     warning_threshold: 0.85
   },
   test_engineer: {
     max_tool_calls: 400,
     max_duration_minutes: 45,
+    max_consecutive_errors: 8,
     warning_threshold: 0.85
   },
   explorer: {
     max_tool_calls: 150,
     max_duration_minutes: 20,
+    max_consecutive_errors: 8,
     warning_threshold: 0.75
   },
   reviewer: {
     max_tool_calls: 200,
     max_duration_minutes: 30,
+    max_consecutive_errors: 8,
     warning_threshold: 0.65
   },
   critic: {
@@ -19463,13 +19474,37 @@ var AuthorityConfigSchema = exports_external.object({
   rules: exports_external.record(exports_external.string(), AgentAuthorityRuleSchema).default({}),
   universal_deny_prefixes: exports_external.array(exports_external.string().min(1)).default([])
 });
+var GeneralCouncilMemberConfigSchema = exports_external.object({
+  memberId: exports_external.string().min(1),
+  model: exports_external.string().min(1),
+  role: exports_external.enum([
+    "generalist",
+    "skeptic",
+    "domain_expert",
+    "devil_advocate",
+    "synthesizer"
+  ]),
+  persona: exports_external.string().optional()
+}).strict();
+var GeneralCouncilConfigSchema = exports_external.object({
+  enabled: exports_external.boolean().default(false),
+  searchProvider: exports_external.enum(["tavily", "brave"]).default("tavily"),
+  searchApiKey: exports_external.string().optional(),
+  members: exports_external.array(GeneralCouncilMemberConfigSchema).default([]),
+  presets: exports_external.record(exports_external.string(), exports_external.array(GeneralCouncilMemberConfigSchema)).default({}),
+  deliberate: exports_external.boolean().default(true),
+  moderator: exports_external.boolean().default(true),
+  moderatorModel: exports_external.string().optional(),
+  maxSourcesPerMember: exports_external.number().int().min(1).max(20).default(5)
+}).strict();
 var CouncilConfigSchema = exports_external.object({
   enabled: exports_external.boolean().default(false),
   maxRounds: exports_external.number().int().min(1).max(10).default(3),
   parallelTimeoutMs: exports_external.number().int().min(5000).max(120000).default(30000),
   vetoPriority: exports_external.boolean().default(true),
   requireAllMembers: exports_external.boolean().default(false).describe("When true, convene_council rejects if fewer than 5 member verdicts are provided."),
-  escalateOnMaxRounds: exports_external.string().optional().describe("Optional webhook URL or handler name invoked when maxRounds is reached without APPROVE. Declared for forward compatibility; no behavior is implemented yet.")
+  escalateOnMaxRounds: exports_external.string().optional().describe("Optional webhook URL or handler name invoked when maxRounds is reached without APPROVE. Declared for forward compatibility; no behavior is implemented yet."),
+  general: GeneralCouncilConfigSchema.optional()
 }).strict();
 var ParallelizationConfigSchema = exports_external.object({
   enabled: exports_external.boolean().default(false),
@@ -19829,7 +19864,8 @@ var DEFAULT_QA_GATES = {
   critic_pre_plan: true,
   hallucination_guard: false,
   sast_enabled: true,
-  mutation_test: false
+  mutation_test: false,
+  council_general_review: false
 };
 function rowToProfile(row) {
   let parsed = {};
@@ -35235,6 +35271,74 @@ async function handleConfigCommand(directory, _args) {
 `);
 }
 
+// src/commands/council.ts
+var MAX_QUESTION_LEN = 2000;
+function sanitizeQuestion(raw) {
+  const collapsed = raw.replace(/\s+/g, " ").trim();
+  const stripped = collapsed.replace(/\[\s*MODE\s*:[^\]]*\]/gi, "");
+  const normalized = stripped.replace(/\s+/g, " ").trim();
+  if (normalized.length <= MAX_QUESTION_LEN)
+    return normalized;
+  return `${normalized.slice(0, MAX_QUESTION_LEN)}\u2026`;
+}
+function sanitizePresetName(raw) {
+  const trimmed = raw.trim();
+  if (!trimmed)
+    return null;
+  if (trimmed.length > 64)
+    return null;
+  if (!/^[A-Za-z0-9_-]+$/.test(trimmed))
+    return null;
+  return trimmed;
+}
+function parseArgs(args) {
+  const out = { specReview: false, rest: [] };
+  for (let i = 0;i < args.length; i++) {
+    const token = args[i];
+    if (token === "--spec-review") {
+      out.specReview = true;
+      continue;
+    }
+    if (token === "--preset") {
+      const next = args[i + 1];
+      if (next !== undefined) {
+        const sanitized = sanitizePresetName(next);
+        if (sanitized)
+          out.preset = sanitized;
+        i++;
+      }
+      continue;
+    }
+    out.rest.push(token);
+  }
+  return out;
+}
+var USAGE = [
+  "Usage: /swarm council <question> [--preset <name>] [--spec-review]",
+  "",
+  "  question         The question to put to the council",
+  "  --preset <name>  Use a named member preset from council.general.presets",
+  "  --spec-review    Use spec_review mode (single advisory pass on a draft spec)",
+  "",
+  "Requires council.general.enabled: true and a configured search API key in opencode-swarm.json."
+].join(`
+`);
+async function handleCouncilCommand(_directory, args) {
+  const parsed = parseArgs(args);
+  const question = sanitizeQuestion(parsed.rest.join(" "));
+  if (!question) {
+    return USAGE;
+  }
+  const tokens = ["MODE: COUNCIL"];
+  if (parsed.preset) {
+    tokens.push(`preset=${parsed.preset}`);
+  }
+  if (parsed.specReview) {
+    tokens.push("spec_review");
+  }
+  return `[${tokens.join(" ")}] ${question}`;
+}
+
 // src/background/event-bus.ts
 init_utils();
 
@@ -43318,7 +43422,8 @@ var ALL_GATE_NAMES = [
   "critic_pre_plan",
   "hallucination_guard",
   "sast_enabled",
-  "mutation_test"
+  "mutation_test",
+  "council_general_review"
 ];
 function derivePlanId(plan) {
   return `${plan.swarm}-${plan.title}`.replace(/[^a-zA-Z0-9-_]/g, "_");
@@ -44219,7 +44324,7 @@ async function handleResetSessionCommand(directory, _args) {
     "",
     "Session state cleared. Plan, evidence, and knowledge preserved.",
     "",
-    "**Next step:** Start a new OpenCode session. The plugin will initialize fresh session state on startup."
+    "**All circuit breakers and revision limits have been cleared.** You can continue in this session \u2014 fresh state will be initialized automatically on the next tool call."
   ].join(`
 `);
 }
@@ -44837,11 +44942,17 @@ var COMMAND_REGISTRY = {
     args: "[topic-text]",
     details: "Triggers the architect to run the brainstorm workflow: CONTEXT SCAN, single-question DIALOGUE, APPROACHES, DESIGN SECTIONS, SPEC WRITE + SELF-REVIEW, QA GATE SELECTION, TRANSITION. Use for new plans where requirements need to be drawn out before writing spec.md / plan.md."
   },
+  council: {
+    handler: (ctx) => handleCouncilCommand(ctx.directory, ctx.args),
+    description: "Enter architect MODE: COUNCIL \u2014 multi-model deliberation [question] [--preset <name>] [--spec-review]",
+    args: "<question> [--preset <name>] [--spec-review]",
+    details: "Triggers the architect to convene a configurable General Council: each member independently web-searches, answers, and engages in one structured deliberation round on disagreements; an optional moderator pass synthesizes the final answer. --preset <name> selects a member group from council.general.presets. --spec-review switches to single-pass advisory mode for spec review. Requires council.general.enabled: true and a search API key in opencode-swarm.json."
+  },
   "qa-gates": {
     handler: (ctx) => handleQaGatesCommand(ctx.directory, ctx.args, ctx.sessionID),
     description: "View or modify QA gate profile for the current plan [enable|override <gate>...]",
     args: "[show|enable|override] <gate>...",
-    details: "show: display spec-level, session-override, and effective QA gates for the current plan. enable: persist gate(s) into the locked-once profile (architect; rejected after critic approval lock). override: session-only ratchet-tighter enable. Valid gates: reviewer, test_engineer, council_mode, sme_enabled, critic_pre_plan, hallucination_guard, sast_enabled, mutation_test."
+    details: "show: display spec-level, session-override, and effective QA gates for the current plan. enable: persist gate(s) into the locked-once profile (architect; rejected after critic approval lock). override: session-only ratchet-tighter enable. Valid gates: reviewer, test_engineer, council_mode, sme_enabled, critic_pre_plan, hallucination_guard, sast_enabled, mutation_test, council_general_review."
   },
   promote: {
     handler: (ctx) => handlePromoteCommand(ctx.directory, ctx.args),

package/dist/commands/council.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Handle /swarm council command.
+ *
+ * Triggers the architect to enter MODE: COUNCIL — the General Council Mode
+ * deliberation workflow (Pre-flight → Round 1 parallel search → Synthesis +
+ * Deliberation → Moderator Pass → Output).
+ *
+ * Flag parsing:
+ *   --preset <name>   → emits "[MODE: COUNCIL preset=<name>] <question>"
+ *   --spec-review     → emits "[MODE: COUNCIL spec_review] <question>"
+ *   default           → emits "[MODE: COUNCIL] <question>"
+ *   no args           → returns usage string (no throw)
+ *
+ * Sanitizes the question to prevent prompt injection of rival MODE: headers
+ * or control sequences (mirrors brainstorm.ts).
+ */
+export declare function handleCouncilCommand(_directory: string, args: string[]): Promise<string>;

package/dist/commands/council.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Tests for /swarm council command handler.
+ */
+export {};

package/dist/commands/index.d.ts

@@ -9,6 +9,7 @@ export { handleCheckpointCommand } from './checkpoint';
 export { handleClarifyCommand } from './clarify';
 export { handleCloseCommand } from './close';
 export { handleConfigCommand } from './config';
+export { handleCouncilCommand } from './council';
 export { handleCurateCommand } from './curate';
 export { handleDarkMatterCommand } from './dark-matter';
 export { handleDiagnoseCommand } from './diagnose';

package/dist/commands/registry.d.ts

@@ -156,11 +156,17 @@ export declare const COMMAND_REGISTRY: {
         readonly args: "[topic-text]";
         readonly details: "Triggers the architect to run the brainstorm workflow: CONTEXT SCAN, single-question DIALOGUE, APPROACHES, DESIGN SECTIONS, SPEC WRITE + SELF-REVIEW, QA GATE SELECTION, TRANSITION. Use for new plans where requirements need to be drawn out before writing spec.md / plan.md.";
     };
+    readonly council: {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Enter architect MODE: COUNCIL — multi-model deliberation [question] [--preset <name>] [--spec-review]";
+        readonly args: "<question> [--preset <name>] [--spec-review]";
+        readonly details: "Triggers the architect to convene a configurable General Council: each member independently web-searches, answers, and engages in one structured deliberation round on disagreements; an optional moderator pass synthesizes the final answer. --preset <name> selects a member group from council.general.presets. --spec-review switches to single-pass advisory mode for spec review. Requires council.general.enabled: true and a search API key in opencode-swarm.json.";
+    };
     readonly 'qa-gates': {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "View or modify QA gate profile for the current plan [enable|override <gate>...]";
         readonly args: "[show|enable|override] <gate>...";
-        readonly details: "show: display spec-level, session-override, and effective QA gates for the current plan. enable: persist gate(s) into the locked-once profile (architect; rejected after critic approval lock). override: session-only ratchet-tighter enable. Valid gates: reviewer, test_engineer, council_mode, sme_enabled, critic_pre_plan, hallucination_guard, sast_enabled, mutation_test.";
+        readonly details: "show: display spec-level, session-override, and effective QA gates for the current plan. enable: persist gate(s) into the locked-once profile (architect; rejected after critic approval lock). override: session-only ratchet-tighter enable. Valid gates: reviewer, test_engineer, council_mode, sme_enabled, critic_pre_plan, hallucination_guard, sast_enabled, mutation_test, council_general_review.";
     };
     readonly promote: {
         readonly handler: (ctx: CommandContext) => Promise<string>;

package/dist/config/constants.d.ts

@@ -2,9 +2,9 @@ import type { ToolName } from '../tools/tool-names';
 export declare const QA_AGENTS: readonly ["reviewer", "critic", "critic_oversight"];
 export declare const PIPELINE_AGENTS: readonly ["explorer", "coder", "test_engineer"];
 export declare const ORCHESTRATOR_NAME: "architect";
-export declare const ALL_SUBAGENT_NAMES: readonly ["sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "curator_init", "curator_phase", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
-export declare const ALL_AGENT_NAMES: readonly ["architect", "sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "curator_init", "curator_phase", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
-export declare const OPENCODE_NATIVE_AGENTS: Set<"compaction" | "title" | "build" | "plan" | "general" | "explore" | "summary">;
+export declare const ALL_SUBAGENT_NAMES: readonly ["sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "curator_init", "curator_phase", "council_member", "council_moderator", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
+export declare const ALL_AGENT_NAMES: readonly ["architect", "sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "curator_init", "curator_phase", "council_member", "council_moderator", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
+export declare const OPENCODE_NATIVE_AGENTS: Set<"compaction" | "title" | "build" | "general" | "plan" | "explore" | "summary">;
 export type QAAgentName = (typeof QA_AGENTS)[number];
 export type PipelineAgentName = (typeof PIPELINE_AGENTS)[number];
 export type AgentName = (typeof ALL_AGENT_NAMES)[number];

package/dist/config/schema.d.ts

@@ -531,6 +531,43 @@ export declare const AuthorityConfigSchema: z.ZodObject<{
     universal_deny_prefixes: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type AuthorityConfig = z.infer<typeof AuthorityConfigSchema>;
+export declare const GeneralCouncilConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    searchProvider: z.ZodDefault<z.ZodEnum<{
+        tavily: "tavily";
+        brave: "brave";
+    }>>;
+    searchApiKey: z.ZodOptional<z.ZodString>;
+    members: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        memberId: z.ZodString;
+        model: z.ZodString;
+        role: z.ZodEnum<{
+            generalist: "generalist";
+            skeptic: "skeptic";
+            domain_expert: "domain_expert";
+            devil_advocate: "devil_advocate";
+            synthesizer: "synthesizer";
+        }>;
+        persona: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    presets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        memberId: z.ZodString;
+        model: z.ZodString;
+        role: z.ZodEnum<{
+            generalist: "generalist";
+            skeptic: "skeptic";
+            domain_expert: "domain_expert";
+            devil_advocate: "devil_advocate";
+            synthesizer: "synthesizer";
+        }>;
+        persona: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>>;
+    deliberate: z.ZodDefault<z.ZodBoolean>;
+    moderator: z.ZodDefault<z.ZodBoolean>;
+    moderatorModel: z.ZodOptional<z.ZodString>;
+    maxSourcesPerMember: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type GeneralCouncilConfig = z.infer<typeof GeneralCouncilConfigSchema>;
 export declare const CouncilConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     maxRounds: z.ZodDefault<z.ZodNumber>;
@@ -538,6 +575,42 @@ export declare const CouncilConfigSchema: z.ZodObject<{
     vetoPriority: z.ZodDefault<z.ZodBoolean>;
     requireAllMembers: z.ZodDefault<z.ZodBoolean>;
     escalateOnMaxRounds: z.ZodOptional<z.ZodString>;
+    general: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        searchProvider: z.ZodDefault<z.ZodEnum<{
+            tavily: "tavily";
+            brave: "brave";
+        }>>;
+        searchApiKey: z.ZodOptional<z.ZodString>;
+        members: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            memberId: z.ZodString;
+            model: z.ZodString;
+            role: z.ZodEnum<{
+                generalist: "generalist";
+                skeptic: "skeptic";
+                domain_expert: "domain_expert";
+                devil_advocate: "devil_advocate";
+                synthesizer: "synthesizer";
+            }>;
+            persona: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        presets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+            memberId: z.ZodString;
+            model: z.ZodString;
+            role: z.ZodEnum<{
+                generalist: "generalist";
+                skeptic: "skeptic";
+                domain_expert: "domain_expert";
+                devil_advocate: "devil_advocate";
+                synthesizer: "synthesizer";
+            }>;
+            persona: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>>;
+        deliberate: z.ZodDefault<z.ZodBoolean>;
+        moderator: z.ZodDefault<z.ZodBoolean>;
+        moderatorModel: z.ZodOptional<z.ZodString>;
+        maxSourcesPerMember: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export type CouncilConfig = z.infer<typeof CouncilConfigSchema>;
 export declare const ParallelizationConfigSchema: z.ZodObject<{
@@ -920,6 +993,42 @@ export declare const PluginConfigSchema: z.ZodObject<{
         vetoPriority: z.ZodDefault<z.ZodBoolean>;
         requireAllMembers: z.ZodDefault<z.ZodBoolean>;
         escalateOnMaxRounds: z.ZodOptional<z.ZodString>;
+        general: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            searchProvider: z.ZodDefault<z.ZodEnum<{
+                tavily: "tavily";
+                brave: "brave";
+            }>>;
+            searchApiKey: z.ZodOptional<z.ZodString>;
+            members: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                memberId: z.ZodString;
+                model: z.ZodString;
+                role: z.ZodEnum<{
+                    generalist: "generalist";
+                    skeptic: "skeptic";
+                    domain_expert: "domain_expert";
+                    devil_advocate: "devil_advocate";
+                    synthesizer: "synthesizer";
+                }>;
+                persona: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            presets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+                memberId: z.ZodString;
+                model: z.ZodString;
+                role: z.ZodEnum<{
+                    generalist: "generalist";
+                    skeptic: "skeptic";
+                    domain_expert: "domain_expert";
+                    devil_advocate: "devil_advocate";
+                    synthesizer: "synthesizer";
+                }>;
+                persona: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>>;
+            deliberate: z.ZodDefault<z.ZodBoolean>;
+            moderator: z.ZodDefault<z.ZodBoolean>;
+            moderatorModel: z.ZodOptional<z.ZodString>;
+            maxSourcesPerMember: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     parallelization: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;

package/dist/council/disagreement-detector.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Disagreement detection for the General Council Mode.
+ *
+ * Pure function module — no I/O, no HTTP, deterministic. Takes Round 1 member
+ * responses, returns the set of factual disagreements that should be routed
+ * back to disputing members for Round 2 reconciliation.
+ *
+ * Two-pass detection:
+ *   Pass 1 — Explicit linguistic markers ("I disagree with", "unlike", etc.)
+ *   Pass 2 — Claim divergence heuristic (mutually exclusive recommendations)
+ *
+ * NSED design note (arXiv:2601.16863): only the disagreement delta is fed
+ * forward to Round 2, not full Round 1 context — mirrors the "semantic forget
+ * gate" selective-retention insight and keeps prompt sizes bounded.
+ */
+import type { GeneralCouncilDisagreement, GeneralCouncilMemberResponse } from './general-council-types.js';
+/**
+ * Detect disagreements across Round 1 member responses.
+ *
+ * Returns at most MAX_DISAGREEMENTS items, deduplicated by topic. Pure function:
+ * given the same input, produces the same output. Empty inputs and missing
+ * fields are handled without throwing.
+ */
+export declare function detectDisagreements(responses: GeneralCouncilMemberResponse[]): GeneralCouncilDisagreement[];