opencode-multiagent 0.2.1 → 0.4.0

package/commands/quality.md

@@ -1,13 +1,14 @@
 ---
-description: Run bounded verification with validator
-agent: validator
-model: openai/gpt-5.3-codex
+description: Run bounded verification and quality checks
+agent: reviewer
+model: anthropic/claude-sonnet-4-6
 subtask: true
 ---
 
 Run the smallest safe verification pass for this scope: $ARGUMENTS
 
 Requirements:
+
 - prefer existing repo-native scripts and commands
 - show the exact commands, exit codes, and what they prove
 - do not invent wide test suites when a narrower signal exists

package/commands/review.md

@@ -1,14 +1,16 @@
 ---
-description: Run a bounded local code review with reviewer
+description: Run a bounded local code review
 agent: reviewer
-model: github-copilot/grok-code-fast-1
+model: anthropic/claude-sonnet-4-6
 subtask: true
 ---
 
 Review this bounded local scope: $ARGUMENTS
 
 Rules:
-- keep the review at 1-3 files or one small diff slice
+
+- keep the review at 1-5 files or one small diff slice
 - report only material issues
 - cite local evidence
+- run verification commands when appropriate
 - if the scope is too broad, say it must be split

package/commands/status.md

@@ -1,15 +1,17 @@
 ---
-description: Lead a .magent status inspection request through critic inspection mode
-agent: lead
+description: Inspect .magent execution state and repository workflow status
+agent: planner
 model: anthropic/claude-opus-4-6
 ---
 
-Own this status request and use `critic` in inspection mode to inspect the current repository execution state.
+Inspect the current repository execution state using Tier 3 inspection mode.
 
 Focus on:
+
 - `.magent/plans/*.md`
 - `.magent/exec/**`
 - active or stale execution artifacts
 - the next best action if the repository already contains plan history
+- `.magent/board.json` — query live task board with `task_list` and include active/pending/blocked tasks
 
 If `.magent` does not exist, say so clearly and summarize what durable state is currently missing.

package/defaults/AGENTS.md

@@ -0,0 +1,48 @@
+# defaults/
+
+Unified plugin configuration defaults and JSON Schema. These two files must always stay in sync.
+
+## Files
+
+- `opencode-multiagent.json` — runtime default values
+- `opencode-multiagent.schema.json` — JSON Schema for validation
+
+## Validation
+
+Run `mise run validate-config` after any change. This uses a **hand-rolled validator** in `scripts/schema-lib.ts` — not `ajv` or any standard JSON Schema library. Do not introduce external schema validation dependencies.
+
+## Schema Structure
+
+The schema enforces `additionalProperties: false` throughout. Adding a new field requires updating both the schema and the defaults file.
+
+Four top-level required sections:
+
+| Section         | Purpose                                                         |
+| --------------- | --------------------------------------------------------------- |
+| `flags`         | Runtime feature flags and configuration                         |
+| `agentSettings` | Per-agent model, temperature, and step overrides                |
+| `mcpDefaults`   | MCP server definitions injected when missing from active config |
+| `profiles`      | Named flag bundles (`minimal`, `standard`, `strict`)            |
+
+## Profile Merge Order
+
+At runtime, flags are resolved in this order (later wins):
+
+1. `defaultFlags` (hardcoded in `constants.ts`)
+2. Profile values (from `profiles[selectedProfile]`)
+3. User flags (from user's `opencode-multiagent.json` in `~/.config/opencode/plugins/`)
+
+## agentSettings
+
+Each entry requires at minimum a `model` field (`provider/model` format). Optional: `temperature` (0–2), `steps` (minimum 1). Every agent in `agents/*.md` must have a corresponding entry here.
+
+## mcpDefaults
+
+MCP server definitions are injected **conservatively** — only when the key is absent from the user's active OpenCode config. They are never overwritten.
+
+## Key Constraints
+
+- **Always run `mise run validate-config` after changes.** The build task depends on it.
+- **Do not use `ajv` or standard JSON Schema validators.** The hand-rolled validator in `scripts/schema-lib.ts` has intentional limitations.
+- **`additionalProperties: false` is enforced everywhere.** Unknown fields will fail validation.
+- **Keep defaults and schema in sync.** A field in one must exist in the other.

package/defaults/opencode-multiagent.json

@@ -0,0 +1,180 @@
+{
+  "flags": {
+    "profile": "standard",
+    "enforcement": true,
+    "observation": true,
+    "prompt_controls": true,
+    "agent_compilation": true,
+    "command_compilation": true,
+    "mcp_compilation": true,
+    "telemetry": true,
+    "supervision": true,
+    "quality_gate": true,
+    "task_lifecycle": true,
+    "quality_gate_enforcement": false,
+    "concurrency_limit": 5,
+    "skill_sources": ["${plugin_root}/skills", "${home}/.agents/skills", "${home}/skills"],
+    "skill_injection": false,
+    "compiler": {
+      "permission_compilation": true
+    },
+    "experimental": {
+      "chat_system_transform": false,
+      "chat_messages_transform": false,
+      "session_compacting": false,
+      "text_complete": false
+    },
+    "supervision_config": {
+      "idle_timeout_ms": 180000,
+      "cooldown_ms": 300000
+    },
+    "quality_config": {
+      "reminder_idle_ms": 120000,
+      "reminder_cooldown_ms": 300000
+    }
+  },
+  "agentSettings": {
+    "planner": {
+      "model": "anthropic/claude-opus-4-6",
+      "temperature": 0,
+      "steps": 200
+    },
+    "executor": {
+      "model": "anthropic/claude-sonnet-4-6",
+      "temperature": 0,
+      "steps": 200
+    },
+    "coder": {
+      "model": "anthropic/claude-sonnet-4-6",
+      "temperature": 0,
+      "steps": 40
+    },
+    "ui-coder": {
+      "model": "anthropic/claude-sonnet-4-6",
+      "temperature": 0,
+      "steps": 40
+    },
+    "sec-coder": {
+      "model": "anthropic/claude-opus-4-6",
+      "temperature": 0,
+      "steps": 60
+    },
+    "reviewer": {
+      "model": "anthropic/claude-sonnet-4-6",
+      "temperature": 0,
+      "steps": 30
+    },
+    "auditor": {
+      "model": "anthropic/claude-opus-4-6",
+      "temperature": 0,
+      "steps": 40
+    },
+    "scout": {
+      "model": "anthropic/claude-sonnet-4-6",
+      "temperature": 0,
+      "steps": 30
+    },
+    "docmaster": {
+      "model": "anthropic/claude-sonnet-4-6",
+      "temperature": 0,
+      "steps": 30
+    }
+  },
+  "mcpDefaults": {
+    "code_index": {
+      "type": "local",
+      "command": ["python3", "-m", "code_index_mcp.server"],
+      "enabled": true
+    },
+    "repo": {
+      "type": "local",
+      "command": ["python3", "-m", "mcp_server_git"],
+      "enabled": true
+    },
+    "context7": {
+      "type": "remote",
+      "url": "https://mcp.context7.com/mcp",
+      "enabled": false
+    },
+    "exa": {
+      "type": "remote",
+      "url": "https://mcp.exa.ai/mcp",
+      "enabled": false
+    },
+    "gh_grep": {
+      "type": "remote",
+      "url": "https://mcp.grep.app",
+      "enabled": false
+    },
+    "github": {
+      "type": "local",
+      "command": ["npx", "-y", "@modelcontextprotocol/server-github"],
+      "environment": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "{env:GITHUB_PAT_TOKEN}"
+      },
+      "enabled": false
+    }
+  },
+  "profiles": {
+    "minimal": {
+      "enforcement": true,
+      "observation": false,
+      "prompt_controls": false,
+      "agent_compilation": true,
+      "command_compilation": true,
+      "mcp_compilation": true,
+      "telemetry": false,
+      "supervision": false,
+      "quality_gate": false,
+      "task_lifecycle": false,
+      "quality_gate_enforcement": false,
+      "concurrency_limit": 0,
+      "experimental": {
+        "chat_system_transform": false,
+        "chat_messages_transform": false,
+        "session_compacting": false,
+        "text_complete": false
+      }
+    },
+    "standard": {
+      "enforcement": true,
+      "observation": true,
+      "prompt_controls": true,
+      "agent_compilation": true,
+      "command_compilation": true,
+      "mcp_compilation": true,
+      "telemetry": true,
+      "supervision": true,
+      "quality_gate": true,
+      "task_lifecycle": true,
+      "quality_gate_enforcement": false,
+      "concurrency_limit": 5,
+      "experimental": {
+        "chat_system_transform": false,
+        "chat_messages_transform": false,
+        "session_compacting": false,
+        "text_complete": false
+      }
+    },
+    "strict": {
+      "enforcement": true,
+      "observation": true,
+      "prompt_controls": true,
+      "agent_compilation": true,
+      "command_compilation": true,
+      "mcp_compilation": true,
+      "telemetry": true,
+      "supervision": true,
+      "quality_gate": true,
+      "task_lifecycle": true,
+      "quality_gate_enforcement": true,
+      "concurrency_limit": 5,
+      "experimental": {
+        "chat_system_transform": true,
+        "chat_messages_transform": true,
+        "session_compacting": true,
+        "text_complete": true
+      }
+    }
+  }
+}

package/defaults/opencode-multiagent.schema.json

@@ -0,0 +1,265 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "opencode-multiagent settings",
+  "description": "Unified bundled settings and schema surface for the OpenCode multi-agent plugin.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "flags": {
+      "title": "opencode-multiagent flags",
+      "description": "Partial runtime overrides for the OpenCode multi-agent control plane plugin.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "profile": {
+          "type": "string",
+          "enum": ["minimal", "standard", "strict"],
+          "description": "Named runtime profile to use as the base flag set."
+        },
+        "enforcement": {
+          "type": "boolean",
+          "description": "Enable local path and shell safety enforcement hooks."
+        },
+        "observation": {
+          "type": "boolean",
+          "description": "Enable JSONL observation logging for events and tool executions."
+        },
+        "prompt_controls": {
+          "type": "boolean",
+          "description": "Enable prompt metadata headers and risky-input logging."
+        },
+        "agent_compilation": {
+          "type": "boolean",
+          "description": "Compile bundled, global, and project agent markdown into config."
+        },
+        "command_compilation": {
+          "type": "boolean",
+          "description": "Compile bundled, global, and project command markdown into config."
+        },
+        "mcp_compilation": {
+          "type": "boolean",
+          "description": "Inject plugin-managed MCP server defaults when missing from config."
+        },
+        "telemetry": {
+          "type": "boolean",
+          "description": "Enable detailed agent and tool telemetry in the plugin JSONL log."
+        },
+        "supervision": {
+          "type": "boolean",
+          "description": "Enable parent-child idle supervision reminders."
+        },
+        "quality_gate": {
+          "type": "boolean",
+          "description": "Enable quality reminder tracking for edited sessions."
+        },
+        "task_lifecycle": {
+          "type": "boolean",
+          "description": "Enable automatic task board updates when child sessions complete."
+        },
+        "quality_gate_enforcement": {
+          "type": "boolean",
+          "description": "Block task completion via task_update unless verification evidence exists."
+        },
+        "concurrency_limit": {
+          "type": "number",
+          "minimum": 0,
+          "description": "Maximum parallel child sessions per parent. 0 means unlimited."
+        },
+        "skill_injection": {
+          "type": "boolean",
+          "description": "Enable dynamic skill registry lookup and prompt injection."
+        },
+        "skill_sources": {
+          "type": "array",
+          "description": "Skill registry search paths. Variables such as ${plugin_root} and ${home} are resolved at runtime.",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 1
+        },
+        "compiler": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "permission_compilation": {
+              "type": "boolean",
+              "description": "Fill missing top-level OpenCode permission defaults conservatively."
+            }
+          }
+        },
+        "experimental": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "chat_system_transform": {
+              "type": "boolean"
+            },
+            "chat_messages_transform": {
+              "type": "boolean"
+            },
+            "session_compacting": {
+              "type": "boolean"
+            },
+            "text_complete": {
+              "type": "boolean"
+            }
+          }
+        },
+        "supervision_config": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "idle_timeout_ms": {
+              "type": "number",
+              "minimum": 0
+            },
+            "cooldown_ms": {
+              "type": "number",
+              "minimum": 0
+            }
+          }
+        },
+        "quality_config": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "reminder_idle_ms": {
+              "type": "number",
+              "minimum": 0
+            },
+            "reminder_cooldown_ms": {
+              "type": "number",
+              "minimum": 0
+            }
+          }
+        }
+      }
+    },
+    "agentSettings": {
+      "title": "opencode-multiagent agent settings",
+      "description": "Central model, temperature, and step overrides per bundled agent.",
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "model": {
+            "type": "string",
+            "pattern": "^[^\\s]+/[^\\s]+$"
+          },
+          "temperature": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 2
+          },
+          "steps": {
+            "type": "number",
+            "minimum": 1
+          }
+        },
+        "required": ["model"]
+      }
+    },
+    "mcpDefaults": {
+      "title": "opencode-multiagent MCP defaults",
+      "description": "Plugin-managed MCP server definitions that are conservatively injected when missing from the active OpenCode config.",
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": ["local", "remote"]
+          },
+          "url": {
+            "type": "string",
+            "minLength": 1
+          },
+          "command": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "minItems": 1
+          },
+          "environment": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            }
+          },
+          "enabled": {
+            "type": "boolean"
+          }
+        },
+        "required": ["type", "enabled"]
+      }
+    },
+    "profiles": {
+      "title": "opencode-multiagent profiles",
+      "description": "Named flag bundles for switching plugin behavior by profile.",
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enforcement": { "type": "boolean" },
+          "observation": { "type": "boolean" },
+          "prompt_controls": { "type": "boolean" },
+          "agent_compilation": { "type": "boolean" },
+          "command_compilation": { "type": "boolean" },
+          "mcp_compilation": { "type": "boolean" },
+          "telemetry": { "type": "boolean" },
+          "supervision": { "type": "boolean" },
+          "quality_gate": { "type": "boolean" },
+          "task_lifecycle": { "type": "boolean" },
+          "quality_gate_enforcement": { "type": "boolean" },
+          "concurrency_limit": { "type": "number", "minimum": 0 },
+          "skill_injection": { "type": "boolean" },
+          "skill_sources": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 },
+            "minItems": 1
+          },
+          "compiler": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "permission_compilation": { "type": "boolean" }
+            }
+          },
+          "experimental": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "chat_system_transform": { "type": "boolean" },
+              "chat_messages_transform": { "type": "boolean" },
+              "session_compacting": { "type": "boolean" },
+              "text_complete": { "type": "boolean" }
+            }
+          },
+          "supervision_config": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "idle_timeout_ms": { "type": "number", "minimum": 0 },
+              "cooldown_ms": { "type": "number", "minimum": 0 }
+            }
+          },
+          "quality_config": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "reminder_idle_ms": { "type": "number", "minimum": 0 },
+              "reminder_cooldown_ms": { "type": "number", "minimum": 0 }
+            }
+          }
+        }
+      }
+    }
+  },
+  "required": ["flags", "agentSettings", "mcpDefaults", "profiles"]
+}

package/dist/control-plane.d.ts

@@ -0,0 +1,4 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+export declare const OpenCodeMultiAgentPlugin: (context: PluginInput) => Promise<import("./opencode-multiagent/hooks.ts").ExtendedHooks>;
+export default OpenCodeMultiAgentPlugin;
+//# sourceMappingURL=control-plane.d.ts.map

package/dist/control-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../src/control-plane.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvD,eAAO,MAAM,wBAAwB,GAAU,SAAS,WAAW,oEAWlE,CAAC;AAEF,eAAe,wBAAwB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import type { Plugin } from '@opencode-ai/plugin';
+declare const plugin: Plugin;
+export default plugin;
+export { plugin as OpenCodeMultiAgentPlugin };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAIlD,QAAA,MAAM,MAAM,EAAE,MAAiC,CAAC;AAEhD,eAAe,MAAM,CAAC;AACtB,OAAO,EAAE,MAAM,IAAI,wBAAwB,EAAE,CAAC"}