opencode-swarm 7.17.2 → 7.17.4

package/dist/cli/index.js

@@ -34,7 +34,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.17.2",
+    version: "7.17.4",
     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",
@@ -51420,7 +51420,7 @@ async function handleTurboCommand(directory, args, sessionID) {
   if (arg0 === "on") {
     let strategy = "standard";
     try {
-      const { config: config3 } = loadPluginConfigWithMeta(directory);
+      const { config: config3 } = _internals25.loadPluginConfigWithMeta(directory);
       if (config3.turbo?.strategy === "lean") {
         strategy = "lean";
       }
@@ -51475,7 +51475,7 @@ function enableLeanTurbo(session, directory, sessionID) {
   let maxParallelCoders = 4;
   let conflictPolicy = "serialize";
   try {
-    const { config: config3 } = loadPluginConfigWithMeta(directory);
+    const { config: config3 } = _internals25.loadPluginConfigWithMeta(directory);
     const leanConfig = config3.turbo?.lean;
     if (leanConfig) {
       maxParallelCoders = leanConfig.max_parallel_coders ?? 4;
@@ -51545,11 +51545,15 @@ function buildStatusMessage(session, directory, sessionID) {
   ].join(`
 `);
 }
+var _internals25;
 var init_turbo = __esm(() => {
   init_config();
   init_state();
   init_state3();
   init_logger();
+  _internals25 = {
+    loadPluginConfigWithMeta
+  };
 });
 
 // src/commands/write-retro.ts
@@ -51802,7 +51806,7 @@ function createSwarmCommandHandler(directory, agents) {
         const attemptedCommand = tokens[0] || "";
         const MAX_DISPLAY = 100;
         const displayCommand = attemptedCommand.length > MAX_DISPLAY ? `${attemptedCommand.slice(0, MAX_DISPLAY)}...` : attemptedCommand;
-        const similar = _internals25.findSimilarCommands(attemptedCommand);
+        const similar = _internals26.findSimilarCommands(attemptedCommand);
         const header = `Command \`/swarm ${displayCommand}\` not found.`;
         const suggestions = similar.length > 0 ? `Did you mean:
 ${similar.map((cmd) => `  \u2022 /swarm ${cmd}`).join(`
@@ -51909,7 +51913,7 @@ function findSimilarCommands(query) {
   }
   const scored = VALID_COMMANDS.map((cmd) => {
     const cmdLower = cmd.toLowerCase();
-    const fullScore = _internals25.levenshteinDistance(q, cmdLower);
+    const fullScore = _internals26.levenshteinDistance(q, cmdLower);
     let tokenScore = Infinity;
     if (cmd.includes(" ") || cmd.includes("-")) {
       const qTokens = q.split(/[\s-]+/);
@@ -51922,7 +51926,7 @@ function findSimilarCommands(query) {
         for (const ct of cmdTokens) {
           if (ct.length === 0)
             continue;
-          const dist = _internals25.levenshteinDistance(qt, ct);
+          const dist = _internals26.levenshteinDistance(qt, ct);
           if (dist < minDist)
             minDist = dist;
         }
@@ -51932,7 +51936,7 @@ function findSimilarCommands(query) {
     }
     const dashStrippedQ = q.replace(/-/g, "");
     const dashStrippedCmd = cmdLower.replace(/-/g, "");
-    const dashScore = _internals25.levenshteinDistance(dashStrippedQ, dashStrippedCmd);
+    const dashScore = _internals26.levenshteinDistance(dashStrippedQ, dashStrippedCmd);
     const score = Math.min(fullScore, tokenScore, dashScore);
     return { cmd, score };
   });
@@ -51964,11 +51968,11 @@ async function handleHelpCommand(ctx) {
     return buildHelpText2();
   }
   const tokens = targetCommand.split(/\s+/);
-  const resolved = _internals25.resolveCommand(tokens);
+  const resolved = _internals26.resolveCommand(tokens);
   if (resolved) {
-    return _internals25.buildDetailedHelp(resolved.key, resolved.entry);
+    return _internals26.buildDetailedHelp(resolved.key, resolved.entry);
   }
-  const similar = _internals25.findSimilarCommands(targetCommand);
+  const similar = _internals26.findSimilarCommands(targetCommand);
   const { buildHelpText: fullHelp } = await Promise.resolve().then(() => (init_commands(), exports_commands));
   if (similar.length > 0) {
     return `Command '/swarm ${targetCommand}' not found.
@@ -52062,7 +52066,7 @@ function resolveCommand(tokens) {
   }
   return null;
 }
-var COMMAND_REGISTRY, VALID_COMMANDS, _internals25, validation;
+var COMMAND_REGISTRY, VALID_COMMANDS, _internals26, validation;
 var init_registry = __esm(() => {
   init_acknowledge_spec_drift();
   init_agents();
@@ -52132,7 +52136,7 @@ var init_registry = __esm(() => {
       clashesWithNativeCcCommand: "/agents"
     },
     help: {
-      handler: (ctx) => _internals25.handleHelpCommand(ctx),
+      handler: (ctx) => _internals26.handleHelpCommand(ctx),
       description: "Show help for swarm commands",
       category: "core",
       args: "[command]",
@@ -52431,9 +52435,24 @@ var init_registry = __esm(() => {
     },
     turbo: {
       handler: (ctx) => handleTurboCommand(ctx.directory, ctx.args, ctx.sessionID),
-      description: "Toggle Turbo Mode for the active session [on|off]",
-      args: "on, off",
-      details: 'Toggles Turbo Mode which skips non-critical QA gates for faster iteration. When enabled, the architect can proceed without waiting for all automated checks. Session-scoped \u2014 resets on new session. Use "on" or "off" to set explicitly, or toggle with no argument.',
+      description: "Toggle Turbo Mode strategy for the active session [on|off|lean|standard|status]",
+      args: "on, off, lean, standard, status",
+      details: `Toggles Turbo Mode for the current session. Supports two strategies:
+
+` + `**Standard turbo** \u2014 skips non-critical QA gates for faster iteration.
+` + `**Lean turbo** \u2014 parallel lane execution with per-lane reviewer gates and file-lock conflict detection.
+` + `
+Subcommands:
+` + `  turbo on           \u2014 enable turbo (uses lean when config turbo.strategy is "lean", otherwise standard)
+` + `  turbo off          \u2014 disable all turbo modes
+` + `  turbo lean on      \u2014 enable Lean Turbo explicitly
+` + `  turbo lean off     \u2014 disable Lean Turbo
+` + `  turbo lean         \u2014 toggle Lean Turbo on/off
+` + `  turbo standard on  \u2014 force standard turbo (disables lean even if config says lean)
+` + `  turbo standard off \u2014 disable standard turbo (falls back to lean if config strategy is lean)
+` + `  turbo status       \u2014 show detailed status including active strategy and lanes
+` + `
+` + "Session-scoped \u2014 resets on new session.",
       category: "utility"
     },
     "full-auto": {
@@ -52489,7 +52508,7 @@ var init_registry = __esm(() => {
     }
   };
   VALID_COMMANDS = Object.keys(COMMAND_REGISTRY);
-  _internals25 = {
+  _internals26 = {
     handleHelpCommand,
     validateAliases,
     resolveCommand,
@@ -52497,7 +52516,7 @@ var init_registry = __esm(() => {
     findSimilarCommands,
     buildDetailedHelp
   };
-  validation = _internals25.validateAliases();
+  validation = _internals26.validateAliases();
   if (!validation.valid) {
     throw new Error(`COMMAND_REGISTRY alias validation failed:
 ${validation.errors.join(`

package/dist/commands/registry.d.ts

@@ -366,9 +366,9 @@ export declare const COMMAND_REGISTRY: {
     };
     readonly turbo: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
-        readonly description: "Toggle Turbo Mode for the active session [on|off]";
-        readonly args: "on, off";
-        readonly details: "Toggles Turbo Mode which skips non-critical QA gates for faster iteration. When enabled, the architect can proceed without waiting for all automated checks. Session-scoped — resets on new session. Use \"on\" or \"off\" to set explicitly, or toggle with no argument.";
+        readonly description: "Toggle Turbo Mode strategy for the active session [on|off|lean|standard|status]";
+        readonly args: "on, off, lean, standard, status";
+        readonly details: string;
         readonly category: "utility";
     };
     readonly 'full-auto': {

package/dist/commands/turbo.d.ts

@@ -1,3 +1,14 @@
+import { loadPluginConfigWithMeta } from '../config';
+/**
+ * Test-only dependency-injection seam. Production code calls
+ * `_internals.loadPluginConfigWithMeta(...)` so tests can replace the function
+ * on this object without using `mock.module` from `bun:test`, which leaks
+ * across files in Bun's shared test-runner process (AGENTS.md §7).
+ * Mutating this local object is file-scoped and trivially restorable via afterEach.
+ */
+export declare const _internals: {
+    loadPluginConfigWithMeta: typeof loadPluginConfigWithMeta;
+};
 /**
  * Handles the /swarm turbo command.
  * Supports standard turbo toggle, lean turbo mode, and status reporting.

package/dist/index.js

@@ -33,7 +33,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.17.2",
+    version: "7.17.4",
     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",
@@ -60218,7 +60218,7 @@ async function handleTurboCommand(directory, args2, sessionID) {
   if (arg0 === "on") {
     let strategy = "standard";
     try {
-      const { config: config3 } = loadPluginConfigWithMeta(directory);
+      const { config: config3 } = _internals31.loadPluginConfigWithMeta(directory);
       if (config3.turbo?.strategy === "lean") {
         strategy = "lean";
       }
@@ -60273,7 +60273,7 @@ function enableLeanTurbo(session, directory, sessionID) {
   let maxParallelCoders = 4;
   let conflictPolicy = "serialize";
   try {
-    const { config: config3 } = loadPluginConfigWithMeta(directory);
+    const { config: config3 } = _internals31.loadPluginConfigWithMeta(directory);
     const leanConfig = config3.turbo?.lean;
     if (leanConfig) {
       maxParallelCoders = leanConfig.max_parallel_coders ?? 4;
@@ -60343,11 +60343,15 @@ function buildStatusMessage(session, directory, sessionID) {
   ].join(`
 `);
 }
+var _internals31;
 var init_turbo = __esm(() => {
   init_config();
   init_state();
   init_state3();
   init_logger();
+  _internals31 = {
+    loadPluginConfigWithMeta
+  };
 });
 
 // src/commands/write-retro.ts
@@ -60600,7 +60604,7 @@ function createSwarmCommandHandler(directory, agents) {
         const attemptedCommand = tokens[0] || "";
         const MAX_DISPLAY = 100;
         const displayCommand = attemptedCommand.length > MAX_DISPLAY ? `${attemptedCommand.slice(0, MAX_DISPLAY)}...` : attemptedCommand;
-        const similar = _internals31.findSimilarCommands(attemptedCommand);
+        const similar = _internals32.findSimilarCommands(attemptedCommand);
         const header = `Command \`/swarm ${displayCommand}\` not found.`;
         const suggestions = similar.length > 0 ? `Did you mean:
 ${similar.map((cmd) => `  • /swarm ${cmd}`).join(`
@@ -60707,7 +60711,7 @@ function findSimilarCommands(query) {
   }
   const scored = VALID_COMMANDS.map((cmd) => {
     const cmdLower = cmd.toLowerCase();
-    const fullScore = _internals31.levenshteinDistance(q, cmdLower);
+    const fullScore = _internals32.levenshteinDistance(q, cmdLower);
     let tokenScore = Infinity;
     if (cmd.includes(" ") || cmd.includes("-")) {
       const qTokens = q.split(/[\s-]+/);
@@ -60720,7 +60724,7 @@ function findSimilarCommands(query) {
         for (const ct of cmdTokens) {
           if (ct.length === 0)
             continue;
-          const dist = _internals31.levenshteinDistance(qt, ct);
+          const dist = _internals32.levenshteinDistance(qt, ct);
           if (dist < minDist)
             minDist = dist;
         }
@@ -60730,7 +60734,7 @@ function findSimilarCommands(query) {
     }
     const dashStrippedQ = q.replace(/-/g, "");
     const dashStrippedCmd = cmdLower.replace(/-/g, "");
-    const dashScore = _internals31.levenshteinDistance(dashStrippedQ, dashStrippedCmd);
+    const dashScore = _internals32.levenshteinDistance(dashStrippedQ, dashStrippedCmd);
     const score = Math.min(fullScore, tokenScore, dashScore);
     return { cmd, score };
   });
@@ -60762,11 +60766,11 @@ async function handleHelpCommand(ctx) {
     return buildHelpText2();
   }
   const tokens = targetCommand.split(/\s+/);
-  const resolved = _internals31.resolveCommand(tokens);
+  const resolved = _internals32.resolveCommand(tokens);
   if (resolved) {
-    return _internals31.buildDetailedHelp(resolved.key, resolved.entry);
+    return _internals32.buildDetailedHelp(resolved.key, resolved.entry);
   }
-  const similar = _internals31.findSimilarCommands(targetCommand);
+  const similar = _internals32.findSimilarCommands(targetCommand);
   const { buildHelpText: fullHelp } = await Promise.resolve().then(() => (init_commands(), exports_commands));
   if (similar.length > 0) {
     return `Command '/swarm ${targetCommand}' not found.
@@ -60860,7 +60864,7 @@ function resolveCommand(tokens) {
   }
   return null;
 }
-var COMMAND_REGISTRY, VALID_COMMANDS, _internals31, validation;
+var COMMAND_REGISTRY, VALID_COMMANDS, _internals32, validation;
 var init_registry = __esm(() => {
   init_acknowledge_spec_drift();
   init_agents();
@@ -60930,7 +60934,7 @@ var init_registry = __esm(() => {
       clashesWithNativeCcCommand: "/agents"
     },
     help: {
-      handler: (ctx) => _internals31.handleHelpCommand(ctx),
+      handler: (ctx) => _internals32.handleHelpCommand(ctx),
       description: "Show help for swarm commands",
       category: "core",
       args: "[command]",
@@ -61229,9 +61233,24 @@ var init_registry = __esm(() => {
     },
     turbo: {
       handler: (ctx) => handleTurboCommand(ctx.directory, ctx.args, ctx.sessionID),
-      description: "Toggle Turbo Mode for the active session [on|off]",
-      args: "on, off",
-      details: 'Toggles Turbo Mode which skips non-critical QA gates for faster iteration. When enabled, the architect can proceed without waiting for all automated checks. Session-scoped — resets on new session. Use "on" or "off" to set explicitly, or toggle with no argument.',
+      description: "Toggle Turbo Mode strategy for the active session [on|off|lean|standard|status]",
+      args: "on, off, lean, standard, status",
+      details: `Toggles Turbo Mode for the current session. Supports two strategies:
+
+` + `**Standard turbo** — skips non-critical QA gates for faster iteration.
+` + `**Lean turbo** — parallel lane execution with per-lane reviewer gates and file-lock conflict detection.
+` + `
+Subcommands:
+` + `  turbo on           — enable turbo (uses lean when config turbo.strategy is "lean", otherwise standard)
+` + `  turbo off          — disable all turbo modes
+` + `  turbo lean on      — enable Lean Turbo explicitly
+` + `  turbo lean off     — disable Lean Turbo
+` + `  turbo lean         — toggle Lean Turbo on/off
+` + `  turbo standard on  — force standard turbo (disables lean even if config says lean)
+` + `  turbo standard off — disable standard turbo (falls back to lean if config strategy is lean)
+` + `  turbo status       — show detailed status including active strategy and lanes
+` + `
+` + "Session-scoped — resets on new session.",
       category: "utility"
     },
     "full-auto": {
@@ -61287,7 +61306,7 @@ var init_registry = __esm(() => {
     }
   };
   VALID_COMMANDS = Object.keys(COMMAND_REGISTRY);
-  _internals31 = {
+  _internals32 = {
     handleHelpCommand,
     validateAliases,
     resolveCommand,
@@ -61295,7 +61314,7 @@ var init_registry = __esm(() => {
     findSimilarCommands,
     buildDetailedHelp
   };
-  validation = _internals31.validateAliases();
+  validation = _internals32.validateAliases();
   if (!validation.valid) {
     throw new Error(`COMMAND_REGISTRY alias validation failed:
 ${validation.errors.join(`
@@ -69908,7 +69927,7 @@ __export(exports_runtime, {
   getSupportedLanguages: () => getSupportedLanguages,
   getInitializedLanguages: () => getInitializedLanguages,
   clearParserCache: () => clearParserCache,
-  _internals: () => _internals32
+  _internals: () => _internals33
 });
 import * as path76 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
@@ -69918,10 +69937,10 @@ async function initTreeSitter() {
       const thisDir = path76.dirname(fileURLToPath2(import.meta.url));
       const isSource = thisDir.replace(/\\/g, "/").endsWith("/src/lang");
       if (isSource) {
-        await _internals32.parserInit();
+        await _internals33.parserInit();
       } else {
         const grammarsDir = getGrammarsDirAbsolute();
-        await _internals32.parserInit({
+        await _internals33.parserInit({
           locateFile(scriptName) {
             return path76.join(grammarsDir, scriptName);
           }
@@ -70023,12 +70042,12 @@ function getInitializedLanguages() {
 function getSupportedLanguages() {
   return Object.keys(LANGUAGE_WASM_MAP);
 }
-var parserCache, initializedLanguages, treeSitterInitPromise = null, _internals32, LANGUAGE_WASM_MAP;
+var parserCache, initializedLanguages, treeSitterInitPromise = null, _internals33, LANGUAGE_WASM_MAP;
 var init_runtime = __esm(() => {
   init_tree_sitter();
   parserCache = new Map;
   initializedLanguages = new Set;
-  _internals32 = {
+  _internals33 = {
     parserInit: Parser.init
   };
   LANGUAGE_WASM_MAP = {
@@ -70485,9 +70504,9 @@ var init_doc_scan = __esm(() => {
 var exports_knowledge_recall = {};
 __export(exports_knowledge_recall, {
   knowledge_recall: () => knowledge_recall,
-  _internals: () => _internals33
+  _internals: () => _internals34
 });
-var knowledge_recall, _internals33;
+var knowledge_recall, _internals34;
 var init_knowledge_recall = __esm(() => {
   init_zod();
   init_knowledge_store();
@@ -70573,7 +70592,7 @@ var init_knowledge_recall = __esm(() => {
       return JSON.stringify(result);
     }
   });
-  _internals33 = {
+  _internals34 = {
     knowledge_recall
   };
 });
@@ -70628,7 +70647,7 @@ __export(exports_curator_drift, {
   runDeterministicDriftCheck: () => runDeterministicDriftCheck,
   readPriorDriftReports: () => readPriorDriftReports,
   buildDriftInjectionText: () => buildDriftInjectionText,
-  _internals: () => _internals35
+  _internals: () => _internals36
 });
 import * as fs60 from "node:fs";
 import * as path84 from "node:path";
@@ -70673,7 +70692,7 @@ async function runDeterministicDriftCheck(directory, phase, curatorResult, confi
   try {
     const planMd = await readSwarmFileAsync(directory, "plan.md");
     const specMd = await readSwarmFileAsync(directory, "spec.md");
-    const priorReports = await _internals35.readPriorDriftReports(directory);
+    const priorReports = await _internals36.readPriorDriftReports(directory);
     const complianceCount = curatorResult.compliance.length;
     const warningCompliance = curatorResult.compliance.filter((obs) => obs.severity === "warning");
     let alignment = "ALIGNED";
@@ -70722,7 +70741,7 @@ async function runDeterministicDriftCheck(directory, phase, curatorResult, confi
       scope_additions: [],
       injection_summary: injectionSummary
     };
-    const reportPath = await _internals35.writeDriftReport(directory, report);
+    const reportPath = await _internals36.writeDriftReport(directory, report);
     getGlobalEventBus().publish("curator.drift.completed", {
       phase,
       alignment,
@@ -70785,12 +70804,12 @@ function buildDriftInjectionText(report, maxChars) {
   }
   return text.slice(0, maxChars);
 }
-var DRIFT_REPORT_PREFIX = "drift-report-phase-", _internals35;
+var DRIFT_REPORT_PREFIX = "drift-report-phase-", _internals36;
 var init_curator_drift = __esm(() => {
   init_event_bus();
   init_logger();
   init_utils2();
-  _internals35 = {
+  _internals36 = {
     readPriorDriftReports,
     writeDriftReport,
     runDeterministicDriftCheck,
@@ -70802,7 +70821,7 @@ var init_curator_drift = __esm(() => {
 var exports_project_context = {};
 __export(exports_project_context, {
   buildProjectContext: () => buildProjectContext,
-  _internals: () => _internals48,
+  _internals: () => _internals50,
   LANG_BACKEND_DETECTION_TIMEOUT_MS: () => LANG_BACKEND_DETECTION_TIMEOUT_MS
 });
 import * as fs110 from "node:fs";
@@ -70886,7 +70905,7 @@ function selectLintCommand(backend, directory) {
   return null;
 }
 async function buildProjectContext(directory) {
-  const backend = await _internals48.pickBackend(directory);
+  const backend = await _internals50.pickBackend(directory);
   if (!backend)
     return null;
   const ctx = emptyProjectContext();
@@ -70917,16 +70936,16 @@ async function buildProjectContext(directory) {
   if (backend.prompts.reviewerChecklist.length > 0) {
     ctx.REVIEWER_CHECKLIST = bulletList(backend.prompts.reviewerChecklist);
   }
-  const profiles = _internals48.pickedProfiles(directory);
+  const profiles = _internals50.pickedProfiles(directory);
   if (profiles.length > 1) {
     ctx.PROJECT_CONTEXT_SECONDARY_LANGUAGES = profiles.slice(1).map((p) => p.id).join(", ");
   }
   return ctx;
 }
-var LANG_BACKEND_DETECTION_TIMEOUT_MS = 300, _internals48;
+var LANG_BACKEND_DETECTION_TIMEOUT_MS = 300, _internals50;
 var init_project_context = __esm(() => {
   init_dispatch();
-  _internals48 = {
+  _internals50 = {
     pickBackend,
     pickedProfiles
   };
@@ -81317,10 +81336,10 @@ async function getRunMemorySummary(directory) {
   if (entries.length === 0) {
     return null;
   }
-  const groups = _internals34.groupByTaskId(entries);
+  const groups = _internals35.groupByTaskId(entries);
   const summaries = [];
   for (const [taskId, taskEntries] of groups) {
-    const summary = _internals34.summarizeTask(taskId, taskEntries);
+    const summary = _internals35.summarizeTask(taskId, taskEntries);
     if (summary) {
       summaries.push(summary);
     }
@@ -81353,7 +81372,7 @@ Use this data to avoid repeating known failure patterns.`;
   }
   return prefix + summaryText + suffix;
 }
-var _internals34 = {
+var _internals35 = {
   generateTaskFingerprint,
   recordOutcome,
   getTaskHistory,
@@ -88866,7 +88885,7 @@ function listLaneEvidenceSync(directory, phase) {
   }
   return laneIds;
 }
-var _internals36 = {
+var _internals37 = {
   listActiveLocks,
   readPersisted: readPersisted2,
   readPlanJson: defaultReadPlanJson,
@@ -88927,7 +88946,7 @@ function verifyLeanTurboPhaseReady(directory, phase, sessionIDOrConfig, config3)
       reason: "Lean Turbo state unreadable or missing"
     };
   }
-  const persisted = _internals36.readPersisted(directory);
+  const persisted = _internals37.readPersisted(directory);
   if (!persisted) {
     return {
       ok: false,
@@ -88991,7 +89010,7 @@ function verifyLeanTurboPhaseReady(directory, phase, sessionIDOrConfig, config3)
     }
   }
   if (runState.lanes.length > 0) {
-    const evidenceLaneIds = new Set(_internals36.listLaneEvidenceSync(directory, phase));
+    const evidenceLaneIds = new Set(_internals37.listLaneEvidenceSync(directory, phase));
     for (const lane of runState.lanes) {
       if ((lane.status === "completed" || lane.status === "failed") && !evidenceLaneIds.has(lane.laneId)) {
         return {
@@ -89001,7 +89020,7 @@ function verifyLeanTurboPhaseReady(directory, phase, sessionIDOrConfig, config3)
       }
     }
   }
-  const activeLocks = _internals36.listActiveLocks(directory);
+  const activeLocks = _internals37.listActiveLocks(directory);
   const phaseLaneIds = new Set(laneIds);
   for (const lock of activeLocks) {
     if (lock.laneId && phaseLaneIds.has(lock.laneId)) {
@@ -89021,7 +89040,7 @@ function verifyLeanTurboPhaseReady(directory, phase, sessionIDOrConfig, config3)
   }
   const serialDegradedTasks = runState.degradedTasks.filter((dt) => !laneTaskIds.has(dt.taskId));
   if (serialDegradedTasks.length > 0) {
-    const plan = _internals36.readPlanJson(directory);
+    const plan = _internals37.readPlanJson(directory);
     if (!plan) {
       return {
         ok: false,
@@ -89065,7 +89084,7 @@ function verifyLeanTurboPhaseReady(directory, phase, sessionIDOrConfig, config3)
   }
   const serializedTasks = runState.serializedTasks;
   if (Array.isArray(serializedTasks) && serializedTasks.length > 0) {
-    const plan = _internals36.readPlanJson(directory);
+    const plan = _internals37.readPlanJson(directory);
     if (!plan) {
       return {
         ok: false,
@@ -89124,7 +89143,7 @@ function verifyLeanTurboPhaseReady(directory, phase, sessionIDOrConfig, config3)
   }
   let reviewerVerdict = runState.lastReviewerVerdict;
   if (!reviewerVerdict) {
-    const evidence = _internals36.readReviewerEvidence(directory, phase);
+    const evidence = _internals37.readReviewerEvidence(directory, phase);
     reviewerVerdict = evidence?.verdict ?? undefined;
   }
   if (mergedConfig.phase_reviewer) {
@@ -89137,7 +89156,7 @@ function verifyLeanTurboPhaseReady(directory, phase, sessionIDOrConfig, config3)
   }
   let criticVerdict = runState.lastCriticVerdict;
   if (!criticVerdict) {
-    const evidence = _internals36.readCriticEvidence(directory, phase);
+    const evidence = _internals37.readCriticEvidence(directory, phase);
     criticVerdict = evidence?.verdict ?? undefined;
   }
   if (mergedConfig.phase_critic) {
@@ -90040,7 +90059,7 @@ Advisory notes: ${advisoryNotes.join("; ")}` : "";
       phase_critic: leanConfig.phase_critic,
       integrated_diff_required: leanConfig.integrated_diff_required
     } : undefined;
-    const leanCheck = _internals36.verifyLeanTurboPhaseReady(dir, phase, sessionID, leanPhaseReadyConfig);
+    const leanCheck = _internals37.verifyLeanTurboPhaseReady(dir, phase, sessionID, leanPhaseReadyConfig);
     if (!leanCheck.ok) {
       return JSON.stringify({
         success: false,
@@ -92228,11 +92247,11 @@ var quality_budget = createSwarmTool({
     }).optional().describe("Quality budget thresholds")
   },
   async execute(args2, directory) {
-    const result = await _internals37.qualityBudget(args2, directory);
+    const result = await _internals38.qualityBudget(args2, directory);
     return JSON.stringify(result);
   }
 });
-var _internals37 = {
+var _internals38 = {
   qualityBudget
 };
 
@@ -92961,7 +92980,7 @@ import * as path109 from "node:path";
 var semgrepAvailableCache = null;
 var DEFAULT_RULES_DIR = ".swarm/semgrep-rules";
 var DEFAULT_TIMEOUT_MS3 = 30000;
-var _internals38 = {
+var _internals39 = {
   isSemgrepAvailable,
   checkSemgrepAvailable,
   resetSemgrepCache,
@@ -92986,7 +93005,7 @@ function isSemgrepAvailable() {
   }
 }
 async function checkSemgrepAvailable() {
-  return _internals38.isSemgrepAvailable();
+  return _internals39.isSemgrepAvailable();
 }
 function resetSemgrepCache() {
   semgrepAvailableCache = null;
@@ -93083,12 +93102,12 @@ async function runSemgrep(options) {
   const timeoutMs = options.timeoutMs || DEFAULT_TIMEOUT_MS3;
   if (files.length === 0) {
     return {
-      available: _internals38.isSemgrepAvailable(),
+      available: _internals39.isSemgrepAvailable(),
       findings: [],
       engine: "tier_a"
     };
   }
-  if (!_internals38.isSemgrepAvailable()) {
+  if (!_internals39.isSemgrepAvailable()) {
     return {
       available: false,
       findings: [],
@@ -93247,7 +93266,7 @@ function assignOccurrenceIndices(findings, directory) {
     }
     const occIdx = countMap.get(baseKey) ?? 0;
     countMap.set(baseKey, occIdx + 1);
-    const fp = _internals39.fingerprintFinding(finding, directory, occIdx);
+    const fp = _internals40.fingerprintFinding(finding, directory, occIdx);
     return {
       finding,
       index: occIdx,
@@ -93316,7 +93335,7 @@ async function captureOrMergeBaseline(directory, phase, findings, engine, scanne
       }
     } catch {}
     const scannedRelFiles = new Set(scannedFiles.map((f) => normalizeFindingPath(directory, f)));
-    const indexed = _internals39.assignOccurrenceIndices(findings, directory);
+    const indexed = _internals40.assignOccurrenceIndices(findings, directory);
     if (existing && !opts?.force) {
       const prunedFingerprints = existing.fingerprints.filter((fp) => {
         const relFile = fp.slice(0, fp.indexOf("|"));
@@ -93456,7 +93475,7 @@ function loadBaseline(directory, phase) {
     };
   }
 }
-var _internals39 = {
+var _internals40 = {
   fingerprintFinding,
   assignOccurrenceIndices,
   captureOrMergeBaseline,
@@ -93866,11 +93885,11 @@ var sast_scan = createSwarmTool({
       capture_baseline: safeArgs.capture_baseline,
       phase: safeArgs.phase
     };
-    const result = await _internals40.sastScan(input, directory);
+    const result = await _internals41.sastScan(input, directory);
     return JSON.stringify(result, null, 2);
   }
 });
-var _internals40 = {
+var _internals41 = {
   sastScan,
   sast_scan
 };
@@ -99053,7 +99072,7 @@ function resolveDefaultReviewerAgent(generatedAgentNames) {
 }
 async function compileReviewPackage(directory, phase, sessionID, requireDiffSummary) {
   const lanes = await listLaneEvidence(directory, phase);
-  const persisted = _internals41.readPersisted?.(directory) ?? null;
+  const persisted = _internals42.readPersisted?.(directory) ?? null;
   if (persisted) {
     let matchingRunState = null;
     for (const sessionState of Object.values(persisted.sessions)) {
@@ -99245,7 +99264,7 @@ Be specific and evidence-based. Do not approve a phase with unresolved degraded
     client.session.delete({ path: { id: sessionId } }).catch(() => {});
   }
 }
-var _internals41 = {
+var _internals42 = {
   compileReviewPackage,
   parseReviewerVerdict,
   writeReviewerEvidence,
@@ -99262,28 +99281,28 @@ async function dispatchPhaseReviewer(directory, phase, sessionID, config3) {
   };
   const generatedAgentNames = swarmState.generatedAgentNames;
   const agentName = mergedConfig.reviewerAgent || resolveDefaultReviewerAgent(generatedAgentNames);
-  const pkg = await _internals41.compileReviewPackage(directory, phase, sessionID, mergedConfig.requireDiffSummary);
+  const pkg = await _internals42.compileReviewPackage(directory, phase, sessionID, mergedConfig.requireDiffSummary);
   let responseText;
   try {
-    responseText = await _internals41.dispatchReviewerAgent(directory, pkg, agentName, mergedConfig.timeoutMs);
+    responseText = await _internals42.dispatchReviewerAgent(directory, pkg, agentName, mergedConfig.timeoutMs);
   } catch (error93) {
-    const evidencePath2 = await _internals41.writeReviewerEvidence(directory, phase, "REJECTED", error93 instanceof Error ? error93.message : String(error93));
+    const evidencePath2 = await _internals42.writeReviewerEvidence(directory, phase, "REJECTED", error93 instanceof Error ? error93.message : String(error93));
     return {
       verdict: "REJECTED",
       reason: `Reviewer dispatch failed: ${error93 instanceof Error ? error93.message : String(error93)}`,
       evidencePath: evidencePath2
     };
   }
-  const parsed = _internals41.parseReviewerVerdict(responseText);
+  const parsed = _internals42.parseReviewerVerdict(responseText);
   if (!parsed) {
-    const evidencePath2 = await _internals41.writeReviewerEvidence(directory, phase, "REJECTED", "Reviewer response could not be parsed");
+    const evidencePath2 = await _internals42.writeReviewerEvidence(directory, phase, "REJECTED", "Reviewer response could not be parsed");
     return {
       verdict: "REJECTED",
       reason: "Reviewer response could not be parsed",
       evidencePath: evidencePath2
     };
   }
-  const evidencePath = await _internals41.writeReviewerEvidence(directory, phase, parsed.verdict, parsed.reason);
+  const evidencePath = await _internals42.writeReviewerEvidence(directory, phase, parsed.verdict, parsed.reason);
   return {
     verdict: parsed.verdict,
     reason: parsed.reason,
@@ -99789,7 +99808,7 @@ ${fileList}
 
 // src/tools/lean-turbo-run-phase.ts
 init_create_tool();
-var _internals42 = {
+var _internals43 = {
   LeanTurboRunner,
   loadPluginConfigWithMeta
 };
@@ -99799,9 +99818,9 @@ async function executeLeanTurboRunPhase(args2) {
   let runError = null;
   let runner = null;
   try {
-    const { config: config3 } = _internals42.loadPluginConfigWithMeta(directory);
+    const { config: config3 } = _internals43.loadPluginConfigWithMeta(directory);
     const leanConfig = config3.turbo?.strategy === "lean" ? config3.turbo.lean : undefined;
-    runner = new _internals42.LeanTurboRunner({
+    runner = new _internals43.LeanTurboRunner({
       directory,
       sessionID,
       opencodeClient: swarmState.opencodeClient ?? null,
@@ -100155,7 +100174,7 @@ function isStaticallyEquivalent(originalCode, mutatedCode) {
   const strippedMutated = stripCode(mutatedCode);
   return strippedOriginal === strippedMutated;
 }
-var _internals43 = {
+var _internals44 = {
   isStaticallyEquivalent,
   checkEquivalence,
   batchCheckEquivalence
@@ -100195,7 +100214,7 @@ async function batchCheckEquivalence(patches, llmJudge) {
   const results = [];
   for (const { patch, originalCode, mutatedCode } of patches) {
     try {
-      const result = await _internals43.checkEquivalence(patch, originalCode, mutatedCode, llmJudge);
+      const result = await _internals44.checkEquivalence(patch, originalCode, mutatedCode, llmJudge);
       results.push(result);
     } catch (err3) {
       results.push({
@@ -100495,7 +100514,7 @@ async function executeMutationSuite(patches, testCommand, testFiles, workingDir,
 }
 
 // src/mutation/gate.ts
-var _internals44 = {
+var _internals45 = {
   evaluateMutationGate,
   buildTestImprovementPrompt,
   buildMessage
@@ -100516,8 +100535,8 @@ function evaluateMutationGate(report, passThreshold = PASS_THRESHOLD, warnThresh
   } else {
     verdict = "fail";
   }
-  const testImprovementPrompt = _internals44.buildTestImprovementPrompt(report, passThreshold, verdict);
-  const message = _internals44.buildMessage(verdict, adjustedKillRate, report.killed, report.totalMutants, report.equivalent, warnThreshold);
+  const testImprovementPrompt = _internals45.buildTestImprovementPrompt(report, passThreshold, verdict);
+  const message = _internals45.buildMessage(verdict, adjustedKillRate, report.killed, report.totalMutants, report.equivalent, warnThreshold);
   return {
     verdict,
     killRate: report.killRate,
@@ -101134,7 +101153,7 @@ import * as path131 from "node:path";
 init_bun_compat();
 import * as fs102 from "node:fs";
 import * as path130 from "node:path";
-var _internals45 = { bunSpawn };
+var _internals46 = { bunSpawn };
 var _swarmGitExcludedChecked = false;
 function fileCoversSwarm(content) {
   for (const rawLine of content.split(`
@@ -101167,7 +101186,7 @@ async function ensureSwarmGitExcluded(directory, options = {}) {
       checkIgnoreExitCode
     ] = await Promise.all([
       (async () => {
-        const proc = _internals45.bunSpawn(["git", "-C", directory, "rev-parse", "--show-toplevel"], GIT_SPAWN_OPTIONS);
+        const proc = _internals46.bunSpawn(["git", "-C", directory, "rev-parse", "--show-toplevel"], GIT_SPAWN_OPTIONS);
         try {
           return await Promise.all([proc.exited, proc.stdout.text()]);
         } finally {
@@ -101177,7 +101196,7 @@ async function ensureSwarmGitExcluded(directory, options = {}) {
         }
       })(),
       (async () => {
-        const proc = _internals45.bunSpawn(["git", "-C", directory, "rev-parse", "--git-path", "info/exclude"], GIT_SPAWN_OPTIONS);
+        const proc = _internals46.bunSpawn(["git", "-C", directory, "rev-parse", "--git-path", "info/exclude"], GIT_SPAWN_OPTIONS);
         try {
           return await Promise.all([proc.exited, proc.stdout.text()]);
         } finally {
@@ -101187,7 +101206,7 @@ async function ensureSwarmGitExcluded(directory, options = {}) {
         }
       })(),
       (async () => {
-        const proc = _internals45.bunSpawn(["git", "-C", directory, "check-ignore", "-q", ".swarm/.gitkeep"], GIT_SPAWN_OPTIONS);
+        const proc = _internals46.bunSpawn(["git", "-C", directory, "check-ignore", "-q", ".swarm/.gitkeep"], GIT_SPAWN_OPTIONS);
         try {
           return await proc.exited;
         } finally {
@@ -101226,7 +101245,7 @@ async function ensureSwarmGitExcluded(directory, options = {}) {
         }
       } catch {}
     }
-    const trackedProc = _internals45.bunSpawn(["git", "-C", directory, "ls-files", "--", ".swarm"], GIT_SPAWN_OPTIONS);
+    const trackedProc = _internals46.bunSpawn(["git", "-C", directory, "ls-files", "--", ".swarm"], GIT_SPAWN_OPTIONS);
     let trackedExitCode;
     let trackedOutput;
     try {
@@ -101251,7 +101270,7 @@ async function ensureSwarmGitExcluded(directory, options = {}) {
 }
 
 // src/hooks/diff-scope.ts
-var _internals46 = { bunSpawn };
+var _internals47 = { bunSpawn };
 function getDeclaredScope(taskId, directory) {
   try {
     const planPath = path131.join(directory, ".swarm", "plan.json");
@@ -101286,7 +101305,7 @@ var GIT_DIFF_SPAWN_OPTIONS = {
 };
 async function getChangedFiles(directory) {
   try {
-    const proc = _internals46.bunSpawn(["git", "diff", "--name-only", "HEAD~1"], {
+    const proc = _internals47.bunSpawn(["git", "diff", "--name-only", "HEAD~1"], {
       cwd: directory,
       ...GIT_DIFF_SPAWN_OPTIONS
     });
@@ -101303,7 +101322,7 @@ async function getChangedFiles(directory) {
       return stdout.trim().split(`
 `).map((f) => f.trim()).filter((f) => f.length > 0);
     }
-    const proc2 = _internals46.bunSpawn(["git", "diff", "--name-only", "HEAD"], {
+    const proc2 = _internals47.bunSpawn(["git", "diff", "--name-only", "HEAD"], {
       cwd: directory,
       ...GIT_DIFF_SPAWN_OPTIONS
     });
@@ -101361,7 +101380,7 @@ init_telemetry();
 init_file_locks();
 import * as fs104 from "node:fs";
 import * as path132 from "node:path";
-var _internals47 = {
+var _internals48 = {
   listActiveLocks,
   verifyLeanTurboTaskCompletion
 };
@@ -101503,7 +101522,7 @@ function verifyLeanTurboTaskCompletion(directory, taskId, sessionID) {
       }
     };
   }
-  const activeLocks = _internals47.listActiveLocks(directory);
+  const activeLocks = _internals48.listActiveLocks(directory);
   const laneLocks = activeLocks.filter((lock) => lock.laneId === lane.laneId);
   if (laneLocks.length > 0) {
     return {
@@ -102426,6 +102445,7 @@ var write_drift_evidence = createSwarmTool({
 // src/tools/write-final-council-evidence.ts
 init_zod();
 init_loader();
+import { randomUUID as randomUUID9 } from "node:crypto";
 import fs107 from "node:fs";
 import path135 from "node:path";
 init_utils2();
@@ -102462,6 +102482,90 @@ var ArgsSchema6 = exports_external.object({
 function normalizeFinalVerdict(verdict) {
   return verdict === "APPROVE" ? "approved" : "rejected";
 }
+var replacementLocks = new Map;
+var _internals49 = {
+  loadPluginConfig,
+  synthesizeFinalCouncilAdvisory,
+  loadPlan,
+  derivePlanId,
+  validateSwarmPath
+};
+function getErrnoCode(error93) {
+  return error93 && typeof error93 === "object" ? error93.code : undefined;
+}
+async function replaceEvidenceFile(tempPath, finalPath) {
+  const previous = replacementLocks.get(finalPath)?.catch(() => {});
+  let release;
+  const current = new Promise((resolve51) => {
+    release = resolve51;
+  });
+  replacementLocks.set(finalPath, current);
+  if (previous) {
+    await previous;
+  }
+  try {
+    await replaceEvidenceFileLocked(tempPath, finalPath);
+  } finally {
+    release();
+    if (replacementLocks.get(finalPath) === current) {
+      replacementLocks.delete(finalPath);
+    }
+  }
+}
+async function replaceEvidenceFileLocked(tempPath, finalPath) {
+  try {
+    await fs107.promises.rename(tempPath, finalPath);
+    return;
+  } catch (error93) {
+    const code = getErrnoCode(error93);
+    if (!["EEXIST", "EPERM", "EACCES"].includes(code ?? "")) {
+      throw error93;
+    }
+  }
+  const backupPath = `${finalPath}.${randomUUID9()}.bak`;
+  let backupCreated = false;
+  try {
+    try {
+      await fs107.promises.rename(finalPath, backupPath);
+      backupCreated = true;
+    } catch (error93) {
+      if (getErrnoCode(error93) !== "ENOENT") {
+        throw error93;
+      }
+    }
+    try {
+      await fs107.promises.rename(tempPath, finalPath);
+    } catch (error93) {
+      if (backupCreated) {
+        if (!await restoreEvidenceBackup(backupPath, finalPath)) {
+          await fs107.promises.rm(backupPath, { force: true }).catch(() => {});
+        }
+        backupCreated = false;
+      }
+      throw error93;
+    }
+    if (backupCreated) {
+      await fs107.promises.rm(backupPath, { force: true }).catch(() => {});
+      backupCreated = false;
+    }
+  } finally {
+    await fs107.promises.rm(tempPath, { force: true }).catch(() => {});
+  }
+}
+async function restoreEvidenceBackup(backupPath, finalPath) {
+  try {
+    await fs107.promises.rename(backupPath, finalPath);
+    return true;
+  } catch {
+    try {
+      await fs107.promises.copyFile(backupPath, finalPath);
+      await fs107.promises.rm(backupPath, { force: true }).catch(() => {});
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}
 async function executeWriteFinalCouncilEvidence(args2, directory) {
   const parsed = ArgsSchema6.safeParse(args2);
   if (!parsed.success) {
@@ -102475,7 +102579,7 @@ async function executeWriteFinalCouncilEvidence(args2, directory) {
     }, null, 2);
   }
   const input = parsed.data;
-  const config3 = loadPluginConfig(directory);
+  const config3 = _internals49.loadPluginConfig(directory);
   const requiredMembers = FINAL_COUNCIL_MEMBERS.length;
   const distinctMembers = new Set(input.verdicts.map((v) => v.agent));
   const membersVoted = [...distinctMembers];
@@ -102490,9 +102594,27 @@ async function executeWriteFinalCouncilEvidence(args2, directory) {
       quorumRequired: requiredMembers
     }, null, 2);
   }
-  const synthesis = synthesizeFinalCouncilAdvisory(input.projectSummary.trim(), input.verdicts, input.roundNumber ?? 1, config3.council);
-  const plan = await loadPlan(directory);
-  const planId = plan ? derivePlanId(plan) : "unknown";
+  let synthesis;
+  try {
+    synthesis = _internals49.synthesizeFinalCouncilAdvisory(input.projectSummary.trim(), input.verdicts, input.roundNumber ?? 1, config3.council);
+  } catch (error93) {
+    return JSON.stringify({
+      success: false,
+      phase: input.phase,
+      message: error93 instanceof Error ? error93.message : "Failed to synthesize final council evidence"
+    }, null, 2);
+  }
+  let planId = "unknown";
+  try {
+    const plan = await _internals49.loadPlan(directory);
+    planId = plan ? _internals49.derivePlanId(plan) : "unknown";
+  } catch (error93) {
+    return JSON.stringify({
+      success: false,
+      phase: input.phase,
+      message: error93 instanceof Error ? error93.message : "Failed to load project plan"
+    }, null, 2);
+  }
   const normalizedVerdict = normalizeFinalVerdict(synthesis.overallVerdict);
   const evidenceEntry = {
     type: "final-council",
@@ -102518,7 +102640,7 @@ async function executeWriteFinalCouncilEvidence(args2, directory) {
   const relativePath = path135.join("evidence", filename);
   let validatedPath;
   try {
-    validatedPath = validateSwarmPath(directory, relativePath);
+    validatedPath = _internals49.validateSwarmPath(directory, relativePath);
   } catch (error93) {
     return JSON.stringify({
       success: false,
@@ -102532,9 +102654,9 @@ async function executeWriteFinalCouncilEvidence(args2, directory) {
   const evidenceDir = path135.dirname(validatedPath);
   try {
     await fs107.promises.mkdir(evidenceDir, { recursive: true });
-    const tempPath = path135.join(evidenceDir, `.${filename}.tmp`);
+    const tempPath = path135.join(evidenceDir, `.${filename}.${randomUUID9()}.tmp`);
     await fs107.promises.writeFile(tempPath, JSON.stringify(evidenceContent, null, 2), "utf-8");
-    await fs107.promises.rename(tempPath, validatedPath);
+    await replaceEvidenceFile(tempPath, validatedPath);
     return JSON.stringify({
       success: true,
       phase: input.phase,

package/dist/tools/write-final-council-evidence.d.ts

@@ -7,7 +7,12 @@
  */
 import type { ToolDefinition } from '@opencode-ai/plugin/tool';
 import { z } from 'zod';
+import { loadPluginConfig } from '../config/loader';
+import { synthesizeFinalCouncilAdvisory } from '../council/council-service';
 import type { CouncilMemberVerdict } from '../council/types';
+import { validateSwarmPath } from '../hooks/utils';
+import { loadPlan } from '../plan/manager.js';
+import { derivePlanId } from '../plan/utils.js';
 export declare const ArgsSchema: z.ZodObject<{
     phase: z.ZodNumber;
     projectSummary: z.ZodString;
@@ -55,6 +60,13 @@ export interface WriteFinalCouncilEvidenceArgs {
     /** Collected verdicts from critic, reviewer, sme, test_engineer, explorer */
     verdicts: CouncilMemberVerdict[];
 }
+export declare const _internals: {
+    loadPluginConfig: typeof loadPluginConfig;
+    synthesizeFinalCouncilAdvisory: typeof synthesizeFinalCouncilAdvisory;
+    loadPlan: typeof loadPlan;
+    derivePlanId: typeof derivePlanId;
+    validateSwarmPath: typeof validateSwarmPath;
+};
 /**
  * Execute the write_final_council_evidence tool.
  * Validates input, synthesizes project-scoped council evidence, and writes it.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.17.2",
+	"version": "7.17.4",
 	"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",