opencode-swarm 6.13.3 → 6.14.0

package/README.md

@@ -76,7 +76,7 @@ This checks that everything is wired up correctly.
 
 ### Configure Models (Optional)
 
-By default, Swarm uses whatever model OpenCode is configured with. To route different agents to different models (recommended), create `.opencode/swarm.json` in your project:
+By default, Swarm v6.14+ uses free OpenCode Zen models (no API key required). You can override any agent's model by creating `.opencode/swarm.json` in your project. See the [LLM Provider Guide](#llm-provider-guide) for all options.
 
 ```json
 {
@@ -127,6 +127,60 @@ Use `/swarm status` at any time to see where things stand.
 
 ---
 
+## LLM Provider Guide
+
+Swarm works with any LLM provider supported by OpenCode. Different agents benefit from different models — the architect needs strong reasoning, the coder needs strong code generation, and the reviewer benefits from a model different from the coder (to catch blind spots).
+
+### Free Tier (OpenCode Zen Models)
+
+OpenCode Zen provides free models via the `opencode/` provider prefix. These are excellent starting points and require no API key:
+
+```json
+{
+  "agents": {
+    "coder":        { "model": "opencode/minimax-m2.5-free" },
+    "reviewer":     { "model": "opencode/big-pickle" },
+    "test_engineer":{ "model": "opencode/gpt-5-nano" },
+    "explorer":     { "model": "opencode/trinity-large-preview-free" },
+    "sme":          { "model": "opencode/trinity-large-preview-free" },
+    "critic":       { "model": "opencode/trinity-large-preview-free" },
+    "docs":         { "model": "opencode/trinity-large-preview-free" },
+    "designer":     { "model": "opencode/trinity-large-preview-free" }
+  }
+}
+```
+
+> Save this configuration to `.opencode/swarm.json` in your project root (or `~/.config/opencode/opencode-swarm.json` for global config).
+
+> **Note:** The `architect` key is intentionally omitted — it inherits whatever model you have selected in the OpenCode UI for maximum reasoning quality.
+
+### Paid Providers
+
+For production use, mix providers to maximize quality across writing vs. reviewing:
+
+| Agent | Recommended Model | Why |
+|---|---|---|
+| `architect` | OpenCode UI selection | Needs strongest reasoning |
+| `coder` | `minimax-coding-plan/MiniMax-M2.5` | Fast, accurate code generation |
+| `reviewer` | `zai-coding-plan/glm-5` | Different training data from coder |
+| `test_engineer` | `minimax-coding-plan/MiniMax-M2.5` | Same strengths as coder |
+| `explorer` | `google/gemini-2.5-flash` | Fast read-heavy analysis |
+| `sme` | `kimi-for-coding/k2p5` | Strong domain expertise |
+| `critic` | `zai-coding-plan/glm-5` | Independent plan review |
+| `docs` | `zai-coding-plan/glm-4.7-flash` | Fast, cost-effective documentation generation |
+| `designer` | `kimi-for-coding/k2p5` | Strong UI/UX generation capabilities |
+
+### Provider Formats
+
+| Provider | Format | Example |
+|---|---|---|
+| OpenCode Zen (free) | `opencode/<model>` | `opencode/trinity-large-preview-free` |
+| Anthropic | `anthropic/<model>` | `anthropic/claude-opus-4-6` |
+| Google | `google/<model>` | `google/gemini-2.5-flash` |
+| Z.ai | `zai-coding-plan/<model>` | `zai-coding-plan/glm-5` |
+| MiniMax | `minimax-coding-plan/<model>` | `minimax-coding-plan/MiniMax-M2.5` |
+| Kimi | `kimi-for-coding/<model>` | `kimi-for-coding/k2p5` |
+
 ## Useful Commands
 
 | Command | What It Does |
@@ -381,6 +435,35 @@ Config file location: `~/.config/opencode/opencode-swarm.json` (global) or `.ope
 
 ### Automation
 
+## Mode Detection (v6.13)
+
+Swarm now explicitly distinguishes five architect modes:
+
+- **`DISCOVER`** — After the explorer finishes scanning the codebase.
+- **`PLAN`** — When the architect writes or updates the plan.
+- **`EXECUTE`** — During task implementation (the normal pipeline).
+- **`PHASE-WRAP`** — After all tasks in a phase are completed, before docs are updated.
+- **`UNKNOWN`** — Fallback when the current state does not match any known mode.
+
+Each mode determines which injection blocks are added to the LLM prompt (e.g., plan cursor is injected in `PLAN`, tool output truncation in `EXECUTE`, etc.).
+
+Default mode: `manual`. No background automation — all actions require explicit slash commands.
+
+Modes:
+
+- `manual` — No background automation. All actions via slash commands (default).
+- `hybrid` — Background automation for safe operations, manual for sensitive ones.
+- `auto` — Full background automation.
+
+Capability defaults:
+
+- `plan_sync`: `true` — Background plan synchronization using `fs.watch` with debounced writes (300ms) and 2-second polling fallback
+- `phase_preflight`: `false` — Phase preflight checks before agent execution (opt-in)
+- `config_doctor_on_startup`: `false` — Validate configuration on startup
+- `config_doctor_autofix`: `false` — Auto-fix for config doctor (opt-in, security-sensitive)
+- `evidence_auto_summaries`: `true` — Automatic summaries for evidence bundles
+- `decision_drift_detection`: `true` — Detect drift between planned and actual decisions
+
 ## Plan Cursor (v6.13)
 
 The `plan_cursor` config compresses the plan that is injected into the LLM context.
@@ -429,37 +512,6 @@ When truncation is active, a footer is appended:
 [output truncated to {maxLines} lines – use `tool_output.per_tool.<tool>` to adjust]
 ```
 
-## Mode Detection (v6.13)
-
-Swarm now explicitly distinguishes five architect modes:
-
-| Mode | When Injected |
-|------|----------------|
-| `DISCOVER` | After the explorer finishes scanning the codebase. |
-| `PLAN` | When the architect writes or updates the plan. |
-| `EXECUTE` | During task implementation (the normal pipeline). |
-| `PHASE-WRAP` | After all tasks in a phase are completed, before docs are updated. |
-| `UNKNOWN` | Fallback when the current state does not match any known mode. |
-
-Each mode determines which injection blocks are added to the LLM prompt (e.g., plan cursor is injected in `PLAN`, tool output truncation in `EXECUTE`, etc.).
-
-Default mode: `manual`. No background automation — all actions require explicit slash commands.
-
-Modes:
-
-- `manual` — No background automation. All actions via slash commands (default).
-- `hybrid` — Background automation for safe operations, manual for sensitive ones.
-- `auto` — Full background automation.
-
-Capability defaults:
-
-- `plan_sync`: `true` — Background plan synchronization using `fs.watch` with debounced writes (300ms) and 2-second polling fallback
-- `phase_preflight`: `false` — Phase preflight checks before agent execution (opt-in)
-- `config_doctor_on_startup`: `false` — Validate configuration on startup
-- `config_doctor_autofix`: `false` — Auto-fix for config doctor (opt-in, security-sensitive)
-- `evidence_auto_summaries`: `true` — Automatic summaries for evidence bundles
-- `decision_drift_detection`: `true` — Detect drift between planned and actual decisions
-
 ---
 
 ### Disabling Agents
@@ -671,6 +723,7 @@ Upcoming: v6.14 focuses on further context optimization and agent coordination i
 - [Design Rationale](docs/design-rationale.md)
 - [Installation Guide](docs/installation.md)
 - [Linux + Docker Desktop Install Guide](docs/installation-linux-docker.md)
+- [LLM Operator Installation Guide](docs/installation-llm-operator.md)
 - [Pre-Swarm Planning Guide](docs/planning.md)
 - [Swarm Briefing for LLMs](docs/swarm-briefing.md)
 

package/dist/cli/index.js

@@ -53,11 +53,14 @@ async function install() {
   if (!fs.existsSync(PLUGIN_CONFIG_PATH)) {
     const defaultConfig = {
       agents: {
-        architect: { model: "anthropic/claude-sonnet-4-20250514" },
-        coder: { model: "anthropic/claude-sonnet-4-20250514" },
-        sme: { model: "google/gemini-2.5-flash" },
-        reviewer: { model: "google/gemini-2.5-flash" },
-        test_engineer: { model: "google/gemini-2.5-flash" }
+        coder: { model: "opencode/minimax-m2.5-free" },
+        reviewer: { model: "opencode/big-pickle" },
+        test_engineer: { model: "opencode/gpt-5-nano" },
+        explorer: { model: "opencode/trinity-large-preview-free" },
+        sme: { model: "opencode/trinity-large-preview-free" },
+        critic: { model: "opencode/trinity-large-preview-free" },
+        docs: { model: "opencode/trinity-large-preview-free" },
+        designer: { model: "opencode/trinity-large-preview-free" }
       },
       max_iterations: 5
     };

package/dist/index.js

@@ -30200,9 +30200,10 @@ function hasCompoundTestExtension(filename) {
 function getTestFilesFromConvention(sourceFiles) {
   const testFiles = [];
   for (const file3 of sourceFiles) {
+    const normalizedPath = file3.replace(/\\/g, "/");
     const basename2 = path12.basename(file3);
     const dirname4 = path12.dirname(file3);
-    if (hasCompoundTestExtension(basename2) || basename2.includes(".spec.") || basename2.includes(".test.")) {
+    if (hasCompoundTestExtension(basename2) || basename2.includes(".spec.") || basename2.includes(".test.") || normalizedPath.includes("/__tests__/") || normalizedPath.includes("/tests/") || normalizedPath.includes("/test/")) {
       if (!testFiles.includes(file3)) {
         testFiles.push(file3);
       }
@@ -31582,16 +31583,15 @@ for (const [agentName, tools] of Object.entries(AGENT_TOOL_MAP)) {
   }
 }
 var DEFAULT_MODELS = {
-  architect: "anthropic/claude-sonnet-4-20250514",
-  explorer: "google/gemini-2.5-flash",
-  coder: "anthropic/claude-sonnet-4-20250514",
-  test_engineer: "google/gemini-2.5-flash",
-  sme: "google/gemini-2.5-flash",
-  reviewer: "google/gemini-2.5-flash",
-  critic: "google/gemini-2.5-flash",
-  docs: "google/gemini-2.5-flash",
-  designer: "google/gemini-2.5-flash",
-  default: "google/gemini-2.5-flash"
+  explorer: "opencode/trinity-large-preview-free",
+  coder: "opencode/minimax-m2.5-free",
+  reviewer: "opencode/big-pickle",
+  test_engineer: "opencode/gpt-5-nano",
+  sme: "opencode/trinity-large-preview-free",
+  critic: "opencode/trinity-large-preview-free",
+  docs: "opencode/trinity-large-preview-free",
+  designer: "opencode/trinity-large-preview-free",
+  default: "opencode/trinity-large-preview-free"
 };
 var DEFAULT_SCORING_CONFIG = {
   enabled: false,
@@ -36890,6 +36890,26 @@ function isOutsideSwarmDir(filePath) {
   const relative2 = path15.relative(swarmDir, resolved);
   return relative2.startsWith("..") || path15.isAbsolute(relative2);
 }
+function isSourceCodePath(filePath) {
+  if (!filePath)
+    return false;
+  const normalized = filePath.replace(/\\/g, "/");
+  const nonSourcePatterns = [
+    /^README(\..+)?$/i,
+    /\/README(\..+)?$/i,
+    /^CHANGELOG(\..+)?$/i,
+    /\/CHANGELOG(\..+)?$/i,
+    /^package\.json$/,
+    /\/package\.json$/,
+    /^\.github\//,
+    /\/\.github\//,
+    /^docs\//,
+    /\/docs\//,
+    /^\.swarm\//,
+    /\/\.swarm\//
+  ];
+  return !nonSourcePatterns.some((pattern) => pattern.test(normalized));
+}
 function isGateTool(toolName) {
   const normalized = toolName.replace(/^[^:]+[:.]/, "");
   const gateTools = [
@@ -36935,7 +36955,7 @@ function createGuardrailsHooks(config3) {
       if (isArchitect(input.sessionID) && isWriteTool(input.tool)) {
         const args2 = output.args;
         const targetPath = args2?.filePath ?? args2?.path ?? args2?.file ?? args2?.target;
-        if (typeof targetPath === "string" && isOutsideSwarmDir(targetPath)) {
+        if (typeof targetPath === "string" && isOutsideSwarmDir(targetPath) && isSourceCodePath(targetPath)) {
           const session2 = swarmState.agentSessions.get(input.sessionID);
           if (session2) {
             session2.architectWriteCount++;
@@ -38758,7 +38778,10 @@ var ECOSYSTEMS = [
     buildFiles: ["build.gradle", "build.gradle.kts", "gradle.properties"],
     toolchainCommands: ["gradle", "gradlew"],
     commands: [
-      { command: "./gradlew build", priority: 1 },
+      {
+        command: process.platform === "win32" ? "gradlew.bat build" : "./gradlew build",
+        priority: 1
+      },
       { command: "gradle build", priority: 2 }
     ]
   },
@@ -40824,7 +40847,7 @@ function normalizeAgentsFromDelegations(delegations) {
 function isValidRetroEntry(entry, phase) {
   return entry.type === "retrospective" && "phase_number" in entry && entry.phase_number === phase && "verdict" in entry && entry.verdict === "pass";
 }
-async function executePhaseComplete(args2) {
+async function executePhaseComplete(args2, workingDirectory) {
   const phase = Number(args2.phase);
   const summary = args2.summary;
   const sessionID = args2.sessionID;
@@ -40855,8 +40878,8 @@ async function executePhaseComplete(args2) {
   const trackedAgents = session.phaseAgentsDispatched ?? new Set;
   const allAgents = new Set([...delegationAgents, ...trackedAgents]);
   const agentsDispatched = Array.from(allAgents).sort();
-  const directory = process.cwd();
-  const { config: config3 } = loadPluginConfigWithMeta(directory);
+  const dir = workingDirectory ?? process.cwd();
+  const { config: config3 } = loadPluginConfigWithMeta(dir);
   let phaseCompleteConfig;
   try {
     phaseCompleteConfig = PhaseCompleteConfigSchema.parse(config3.phase_complete ?? {});
@@ -40882,16 +40905,16 @@ async function executePhaseComplete(args2) {
       warnings: []
     }, null, 2);
   }
-  const retroBundle = await loadEvidence(directory, `retro-${phase}`);
+  const retroBundle = await loadEvidence(dir, `retro-${phase}`);
   let retroFound = false;
   if (retroBundle !== null) {
     retroFound = retroBundle.entries?.some((entry) => isValidRetroEntry(entry, phase)) ?? false;
   }
   if (!retroFound) {
-    const allTaskIds = await listEvidenceTaskIds(directory);
+    const allTaskIds = await listEvidenceTaskIds(dir);
     const retroTaskIds = allTaskIds.filter((id) => id.startsWith("retro-"));
     for (const taskId of retroTaskIds) {
-      const bundle = await loadEvidence(directory, taskId);
+      const bundle = await loadEvidence(dir, taskId);
       if (bundle === null)
         continue;
       retroFound = bundle.entries?.some((entry) => isValidRetroEntry(entry, phase)) ?? false;
@@ -40945,7 +40968,7 @@ async function executePhaseComplete(args2) {
     summary: safeSummary ?? null
   };
   try {
-    const eventsPath = validateSwarmPath(directory, "events.jsonl");
+    const eventsPath = validateSwarmPath(dir, "events.jsonl");
     fs17.appendFileSync(eventsPath, `${JSON.stringify(event)}
 `, "utf-8");
   } catch (writeError) {

package/dist/tools/phase-complete.d.ts

@@ -3,6 +3,22 @@
  * Core implementation - gathers data, enforces policy, writes event, resets state.
  */
 import { type ToolDefinition } from '@opencode-ai/plugin/tool';
+/**
+ * Arguments for the phase_complete tool
+ */
+export interface PhaseCompleteArgs {
+    /** The phase number being completed */
+    phase: number;
+    /** Optional summary of the phase */
+    summary?: string;
+    /** Session ID to track state (optional, defaults to current session context) */
+    sessionID?: string;
+}
+/**
+ * Execute the phase_complete tool
+ * Gathers data, enforces policy, writes event, resets state
+ */
+export declare function executePhaseComplete(args: PhaseCompleteArgs, workingDirectory?: string): Promise<string>;
 /**
  * Tool definition for phase_complete
  */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "6.13.3",
+	"version": "6.14.0",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -34,9 +34,8 @@
 		"LICENSE"
 	],
 	"scripts": {
-		"clean": "rm -rf dist",
-		"copy-grammars": "bun run scripts/copy-grammars.ts",
-		"build": "rm -rf dist && bun run copy-grammars && bun build src/index.ts --outdir dist --target bun --format esm && bun build src/cli/index.ts --outdir dist/cli --target bun --format esm && bun run scripts/copy-grammars.ts --to-dist && tsc --emitDeclarationOnly",
+		"clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+		"build": "bun run clean && bun run scripts/copy-grammars.ts && bun build src/index.ts --outdir dist --target bun --format esm && bun build src/cli/index.ts --outdir dist/cli --target bun --format esm && bun run scripts/copy-grammars.ts --to-dist && tsc --emitDeclarationOnly",
 		"typecheck": "tsc --noEmit",
 		"test": "bun test",
 		"lint": "biome lint .",