opencode-swarm 7.18.3 → 7.19.1

package/dist/cli/index.js

@@ -34,7 +34,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.18.3",
+    version: "7.19.1",
     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",
@@ -14893,6 +14893,17 @@ function applyEventToPlan(plan, event) {
       return plan;
     case "task_added":
       return plan;
+    case "task_removed":
+      if (event.task_id) {
+        for (const phase of plan.phases) {
+          const idx = phase.tasks.findIndex((t) => t.id === event.task_id);
+          if (idx !== -1) {
+            phase.tasks.splice(idx, 1);
+            break;
+          }
+        }
+      }
+      return plan;
     case "task_updated":
       return plan;
     case "plan_rebuilt":
@@ -15000,7 +15011,7 @@ async function loadLastApprovedPlan(directory, expectedPlanId) {
   }
   return null;
 }
-var LEDGER_SCHEMA_VERSION = "1.0.0", LEDGER_FILENAME = "plan-ledger.jsonl", PLAN_JSON_FILENAME = "plan.json", LedgerStaleWriterError;
+var LEDGER_SCHEMA_VERSION = "1.1.0", LEDGER_FILENAME = "plan-ledger.jsonl", PLAN_JSON_FILENAME = "plan.json", LedgerStaleWriterError;
 var init_ledger = __esm(() => {
   init_plan_schema();
   LedgerStaleWriterError = class LedgerStaleWriterError extends Error {
@@ -15290,7 +15301,13 @@ async function loadPlan(directory) {
         const planMdContent2 = await readSwarmFileAsync(directory, "plan.md");
         if (planMdContent2 !== null) {
           const migrated = migrateLegacyPlan(planMdContent2);
-          await savePlan(directory, migrated);
+          const { removedCount } = await savePlanWithAutoAcknowledgedRemovals(directory, migrated, "load_plan_migration_from_md", "migrate legacy plan.md to plan.json");
+          if (removedCount > 0) {
+            migrated._midLoadRemovals = {
+              count: removedCount,
+              source: "load_plan_migration_from_md"
+            };
+          }
           return migrated;
         }
       }
@@ -15319,7 +15336,13 @@ async function loadPlan(directory) {
     try {
       const rebuilt = await replayFromLedger(directory);
       if (rebuilt) {
-        await savePlan(directory, rebuilt);
+        const { removedCount } = await savePlanWithAutoAcknowledgedRemovals(directory, rebuilt, "load_plan_rebuild_from_ledger", "rebuild plan from ledger replay");
+        if (removedCount > 0) {
+          rebuilt._midLoadRemovals = {
+            count: removedCount,
+            source: "load_plan_rebuild_from_ledger"
+          };
+        }
         return rebuilt;
       }
       try {
@@ -15333,7 +15356,13 @@ async function loadPlan(directory) {
         if (approved) {
           const approvedPhase = approved.approval && typeof approved.approval === "object" && "phase" in approved.approval ? approved.approval.phase : undefined;
           warn(`[loadPlan] Ledger replay returned no plan \u2014 recovered from critic-approved snapshot seq=${approved.seq} timestamp=${approved.timestamp} (approval phase=${approvedPhase ?? "unknown"}). This may roll the plan back to an earlier phase \u2014 verify before continuing.`);
-          await savePlan(directory, approved.plan);
+          const { removedCount: snapshotRemovedCount } = await savePlanWithAutoAcknowledgedRemovals(directory, approved.plan, "load_plan_recovery_from_approved_snapshot", "restore from critic-approved snapshot");
+          if (snapshotRemovedCount > 0) {
+            approved.plan._midLoadRemovals = {
+              count: snapshotRemovedCount,
+              source: "load_plan_recovery_from_approved_snapshot"
+            };
+          }
           try {
             await takeSnapshotEvent(directory, approved.plan, {
               source: "recovery_from_approved_snapshot",
@@ -15354,6 +15383,28 @@ async function loadPlan(directory) {
   }
   return null;
 }
+async function savePlanWithAutoAcknowledgedRemovals(directory, plan, source, reason, options) {
+  const existing = await _internals3.loadPlanJsonOnly(directory);
+  const newIds = new Set;
+  for (const phase of plan.phases) {
+    for (const task of phase.tasks)
+      newIds.add(task.id);
+  }
+  const removedIds = [];
+  if (existing) {
+    for (const phase of existing.phases) {
+      for (const task of phase.tasks) {
+        if (!newIds.has(task.id))
+          removedIds.push(task.id);
+      }
+    }
+  }
+  await savePlan(directory, plan, {
+    ...options ?? {},
+    acknowledged_removals: { ids: removedIds, reason, source }
+  });
+  return { removedCount: removedIds.length };
+}
 async function savePlan(directory, plan, options) {
   if (directory === null || directory === undefined || typeof directory !== "string" || directory.trim().length === 0) {
     throw new Error(`Invalid directory: directory must be a non-empty string`);
@@ -15490,6 +15541,73 @@ async function savePlan(directory, plan, options) {
         oldTaskMap.set(task.id, { phase: task.phase, status: task.status });
       }
     }
+    const newTaskIds = new Set;
+    for (const phase of validated.phases) {
+      for (const task of phase.tasks)
+        newTaskIds.add(task.id);
+    }
+    const missingTasks = [];
+    for (const [id, info] of oldTaskMap.entries()) {
+      if (!newTaskIds.has(id)) {
+        missingTasks.push({ id, phase: info.phase, status: info.status });
+      }
+    }
+    const ack = options?.acknowledged_removals;
+    if (missingTasks.length > 0) {
+      if (!ack) {
+        throw new PlanTaskRemovalNotAcknowledgedError(missingTasks);
+      }
+      if (typeof ack.reason !== "string" || ack.reason.trim().length === 0) {
+        throw new Error("PLAN_ACKNOWLEDGED_REMOVAL_INVALID: acknowledged_removals.reason must be a non-empty string.");
+      }
+      if (typeof ack.source !== "string" || ack.source.trim().length === 0) {
+        throw new Error("PLAN_ACKNOWLEDGED_REMOVAL_INVALID: acknowledged_removals.source must be a non-empty string.");
+      }
+      const ackSet = new Set(ack.ids);
+      const missingIdsSet = new Set(missingTasks.map((t) => t.id));
+      const unacked = missingTasks.filter((t) => !ackSet.has(t.id));
+      if (unacked.length > 0) {
+        throw new PlanTaskRemovalNotAcknowledgedError(unacked);
+      }
+      for (const id of ack.ids) {
+        if (!missingIdsSet.has(id)) {
+          throw new Error(`PLAN_ACKNOWLEDGED_REMOVAL_INVALID: acknowledged_removals contains "${id}" but that task is not missing from the plan.`);
+        }
+      }
+      try {
+        for (const missing of missingTasks) {
+          const eventInput = {
+            plan_id: derivePlanId(validated),
+            event_type: "task_removed",
+            task_id: missing.id,
+            phase_id: missing.phase,
+            from_status: missing.status,
+            source: ack.source,
+            payload: { reason: ack.reason, source: ack.source }
+          };
+          const capturedTaskId = missing.id;
+          await retryCasWithBackoff(directory, eventInput, {
+            expectedHash: currentHash,
+            planHashAfter: hashAfter,
+            verifyValid: async () => {
+              const onDisk = await _internals3.loadPlanJsonOnly(directory);
+              if (!onDisk)
+                return true;
+              for (const p of onDisk.phases) {
+                if (p.tasks.some((x) => x.id === capturedTaskId))
+                  return true;
+              }
+              return false;
+            }
+          });
+        }
+      } catch (error49) {
+        if (error49 instanceof LedgerStaleWriterError) {
+          throw new PlanConcurrentModificationError(`Concurrent plan modification detected after retries: ${error49.message}. Please retry the operation.`);
+        }
+        throw error49;
+      }
+    }
     try {
       for (const phase of validated.phases) {
         for (const task of phase.tasks) {
@@ -15890,7 +16008,7 @@ function migrateLegacyPlan(planContent, swarmId) {
   };
   return plan;
 }
-var PlanConcurrentModificationError, startupLedgerCheckedWorkspaces, recoveryMutexes, _internals3, CAS_BACKOFF_START_MS = 5, CAS_BACKOFF_CAP_MS = 250, CAS_BACKOFF_JITTER = 0.25, CAS_MAX_RETRIES = 3;
+var PlanConcurrentModificationError, PlanTaskRemovalNotAcknowledgedError, startupLedgerCheckedWorkspaces, recoveryMutexes, _internals3, CAS_BACKOFF_START_MS = 5, CAS_BACKOFF_CAP_MS = 250, CAS_BACKOFF_JITTER = 0.25, CAS_MAX_RETRIES = 3;
 var init_manager = __esm(() => {
   init_plan_schema();
   init_utils2();
@@ -15905,6 +16023,15 @@ var init_manager = __esm(() => {
       this.name = "PlanConcurrentModificationError";
     }
   };
+  PlanTaskRemovalNotAcknowledgedError = class PlanTaskRemovalNotAcknowledgedError extends Error {
+    missingTasks;
+    constructor(missingTasks) {
+      const idList = missingTasks.map((t) => `${t.id}(${t.status})`).join(", ");
+      super(`PLAN_TASK_REMOVAL_NOT_ACKNOWLEDGED: the following tasks were present in the prior plan but missing from the new save: ${idList}. Pass acknowledged_removals.ids covering all missing task IDs with a non-empty reason to proceed.`);
+      this.name = "PlanTaskRemovalNotAcknowledgedError";
+      this.missingTasks = missingTasks;
+    }
+  };
   startupLedgerCheckedWorkspaces = new Set;
   recoveryMutexes = new Map;
   _internals3 = {
@@ -16064,6 +16191,7 @@ var init_tool_names = __esm(() => {
     "skill_improve",
     "spec_write",
     "knowledge_ack",
+    "swarm_command",
     "lean_turbo_plan_lanes",
     "lean_turbo_acquire_locks",
     "lean_turbo_runner_status",
@@ -16316,6 +16444,7 @@ var init_constants = __esm(() => {
       "skill_inspect",
       "skill_improve",
       "knowledge_ack",
+      "swarm_command",
       "lean_turbo_plan_lanes",
       "lean_turbo_acquire_locks",
       "lean_turbo_runner_status",
@@ -16337,7 +16466,8 @@ var init_constants = __esm(() => {
       "todo_extract",
       "doc_scan",
       "knowledge_recall",
-      "repo_map"
+      "repo_map",
+      "swarm_command"
     ],
     coder: [
       "diff",
@@ -16351,7 +16481,8 @@ var init_constants = __esm(() => {
       "syntax_check",
       "knowledge_add",
       "knowledge_recall",
-      "repo_map"
+      "repo_map",
+      "swarm_command"
     ],
     test_engineer: [
       "test_runner",
@@ -16366,7 +16497,8 @@ var init_constants = __esm(() => {
       "pkg_audit",
       "build_check",
       "syntax_check",
-      "search"
+      "search",
+      "swarm_command"
     ],
     sme: [
       "complexity_hotspots",
@@ -16377,7 +16509,8 @@ var init_constants = __esm(() => {
       "schema_drift",
       "search",
       "symbols",
-      "knowledge_recall"
+      "knowledge_recall",
+      "swarm_command"
     ],
     reviewer: [
       "diff",
@@ -16399,7 +16532,8 @@ var init_constants = __esm(() => {
       "search",
       "batch_symbols",
       "suggest_patch",
-      "repo_map"
+      "repo_map",
+      "swarm_command"
     ],
     critic: [
       "complexity_hotspots",
@@ -16410,7 +16544,8 @@ var init_constants = __esm(() => {
       "knowledge_recall",
       "req_coverage",
       "get_approved_plan",
-      "repo_map"
+      "repo_map",
+      "swarm_command"
     ],
     critic_sounding_board: [
       "complexity_hotspots",
@@ -16478,14 +16613,16 @@ var init_constants = __esm(() => {
       "search",
       "symbols",
       "todo_extract",
-      "knowledge_recall"
+      "knowledge_recall",
+      "swarm_command"
     ],
     designer: [
       "extract_code_blocks",
       "retrieve_summary",
       "search",
       "symbols",
-      "knowledge_recall"
+      "knowledge_recall",
+      "swarm_command"
     ],
     curator_init: ["knowledge_recall"],
     curator_phase: ["knowledge_recall"],
@@ -16501,7 +16638,8 @@ var init_constants = __esm(() => {
       "skill_improve",
       "search",
       "doc_scan",
-      "doc_extract"
+      "doc_extract",
+      "web_search"
     ],
     spec_writer: [
       "search",
@@ -16585,6 +16723,7 @@ var init_constants = __esm(() => {
     skill_improve: "run the skill_improver agent to review and refine skills",
     spec_write: "author or update .swarm/spec.md for the current project",
     knowledge_ack: "record an explicit KNOWLEDGE_APPLIED/IGNORED/VIOLATED acknowledgment",
+    swarm_command: "run supported /swarm commands through the canonical command registry",
     lean_turbo_plan_lanes: "partition phase tasks into parallel lanes based on file-scope conflicts for Lean Turbo execution",
     lean_turbo_acquire_locks: "acquire file locks for all files in a lane (all-or-nothing) before lane execution",
     lean_turbo_runner_status: "read Lean Turbo run state from .swarm/turbo-state.json",
@@ -16601,67 +16740,67 @@ var init_constants = __esm(() => {
   DEFAULT_AGENT_CONFIGS = {
     coder: {
       model: "opencode/minimax-m2.5-free",
-      fallback_models: ["opencode/big-pickle"]
+      fallback_models: ["opencode/gpt-5-nano", "opencode/big-pickle"]
     },
     reviewer: {
       model: "opencode/big-pickle",
-      fallback_models: ["opencode/minimax-m2.5-free"]
+      fallback_models: ["opencode/gpt-5-nano", "opencode/big-pickle"]
     },
     test_engineer: {
-      model: "opencode/big-pickle",
-      fallback_models: ["opencode/minimax-m2.5-free"]
+      model: "opencode/gpt-5-nano",
+      fallback_models: ["opencode/big-pickle"]
     },
     explorer: {
       model: "opencode/big-pickle",
-      fallback_models: ["opencode/minimax-m2.5-free"]
+      fallback_models: ["opencode/gpt-5-nano", "opencode/big-pickle"]
     },
     sme: {
       model: "opencode/big-pickle",
-      fallback_models: ["opencode/minimax-m2.5-free"]
+      fallback_models: ["opencode/gpt-5-nano", "opencode/big-pickle"]
     },
     critic: {
       model: "opencode/big-pickle",
-      fallback_models: ["opencode/minimax-m2.5-free"]
+      fallback_models: ["opencode/gpt-5-nano", "opencode/big-pickle"]
     },
     docs: {
       model: "opencode/big-pickle",
-      fallback_models: ["opencode/minimax-m2.5-free"]
+      fallback_models: ["opencode/gpt-5-nano", "opencode/big-pickle"]
     },
     designer: {
       model: "opencode/big-pickle",
-      fallback_models: ["opencode/minimax-m2.5-free"]
+      fallback_models: ["opencode/gpt-5-nano", "opencode/big-pickle"]
     },
     critic_sounding_board: {
-      model: "opencode/big-pickle",
-      fallback_models: ["opencode/minimax-m2.5-free"]
+      model: "opencode/gpt-5-nano",
+      fallback_models: ["opencode/big-pickle"]
     },
     critic_drift_verifier: {
-      model: "opencode/big-pickle",
-      fallback_models: ["opencode/minimax-m2.5-free"]
+      model: "opencode/gpt-5-nano",
+      fallback_models: ["opencode/big-pickle"]
     },
     critic_hallucination_verifier: {
-      model: "opencode/big-pickle",
-      fallback_models: ["opencode/minimax-m2.5-free"]
+      model: "opencode/gpt-5-nano",
+      fallback_models: ["opencode/big-pickle"]
     },
     critic_oversight: {
-      model: "opencode/big-pickle",
-      fallback_models: ["opencode/minimax-m2.5-free"]
+      model: "opencode/gpt-5-nano",
+      fallback_models: ["opencode/big-pickle"]
     },
     curator_init: {
-      model: "opencode/big-pickle",
-      fallback_models: ["opencode/minimax-m2.5-free"]
+      model: "opencode/gpt-5-nano",
+      fallback_models: ["opencode/big-pickle"]
     },
     curator_phase: {
-      model: "opencode/big-pickle",
-      fallback_models: ["opencode/minimax-m2.5-free"]
+      model: "opencode/gpt-5-nano",
+      fallback_models: ["opencode/big-pickle"]
     },
     skill_improver: {
       model: "opencode/big-pickle",
-      fallback_models: ["opencode/minimax-m2.5-free"]
+      fallback_models: ["opencode/gpt-5-nano"]
     },
     spec_writer: {
       model: "opencode/big-pickle",
-      fallback_models: ["opencode/minimax-m2.5-free"]
+      fallback_models: ["opencode/gpt-5-nano"]
     }
   };
 });
@@ -17544,8 +17683,7 @@ function handleAgentsCommand(agents, guardrails) {
   if (hasUnregistered) {
     lines.push("", "### Unregistered Subagents");
     for (const name of unregistered) {
-      const hint = UNREGISTERED_AGENT_HINTS[name] ?? "requires configuration";
-      lines.push(`- **${name}** (${hint})`);
+      lines.push(`- **${name}** (requires configuration)`);
     }
   }
   if (guardrails?.profiles && Object.keys(guardrails.profiles).length > 0) {
@@ -17574,18 +17712,9 @@ function handleAgentsCommand(agents, guardrails) {
   return lines.join(`
 `);
 }
-var UNREGISTERED_AGENT_HINTS;
 var init_agents = __esm(() => {
   init_constants();
   init_schema();
-  UNREGISTERED_AGENT_HINTS = {
-    designer: "enable ui_review.enabled",
-    council_generalist: "enable council.general.enabled",
-    council_skeptic: "enable council.general.enabled",
-    council_domain_expert: "enable council.general.enabled",
-    skill_improver: "registered by default unless agents.skill_improver.disabled is true",
-    spec_writer: "registered by default unless agents.spec_writer.disabled is true"
-  };
 });
 
 // src/commands/analyze.ts
@@ -20236,13 +20365,6 @@ var init_qa_gate_profile = __esm(() => {
     final_council: false
   };
 });
-// src/parallel/runtime-config.ts
-var lockedProfileCache;
-var init_runtime_config = __esm(() => {
-  init_plan_schema();
-  lockedProfileCache = new Map;
-});
-
 // node_modules/quick-lru/index.js
 var QuickLRU;
 var init_quick_lru = __esm(() => {
@@ -20826,7 +20948,7 @@ var init_model_limits = __esm(() => {
 var init_normalize_tool_name = () => {};
 
 // src/hooks/guardrails.ts
-var storedInputArgs, TRANSIENT_STATUS_CODES, toolCallsSinceLastWrite, noOpWarningIssued, consecutiveNoToolTurns, DC_SAFE_TARGETS, DC_FS_ROOTS, pathNormalizationCache, globMatcherCache;
+var SPEC_DRIFT_BLOCKED_TOOLS, storedInputArgs, TRANSIENT_STATUS_CODES, toolCallsSinceLastWrite, noOpWarningIssued, consecutiveNoToolTurns, DC_SAFE_TARGETS, DC_FS_ROOTS, pathNormalizationCache, globMatcherCache;
 var init_guardrails = __esm(() => {
   init_quick_lru();
   init_agents2();
@@ -20845,6 +20967,13 @@ var init_guardrails = __esm(() => {
   init_loop_detector();
   init_model_limits();
   init_normalize_tool_name();
+  SPEC_DRIFT_BLOCKED_TOOLS = new Set([
+    "save_plan",
+    "update_task_status",
+    "phase_complete",
+    "lean_turbo_run_phase",
+    "lean_turbo_acquire_locks"
+  ]);
   storedInputArgs = new Map;
   TRANSIENT_STATUS_CODES = new Set([408, 429, 500, 502, 503, 504, 529]);
   toolCallsSinceLastWrite = new Map;
@@ -20888,7 +21017,6 @@ function clearPendingCoderScope() {
 var pendingCoderScopeByTaskId;
 var init_delegation_gate = __esm(() => {
   init_schema();
-  init_runtime_config();
   init_state();
   init_telemetry();
   init_logger();
@@ -38256,31 +38384,12 @@ function parseArgs(args) {
   }
   return out;
 }
-async function handleCouncilCommand(directory, args) {
+async function handleCouncilCommand(_directory, args) {
   const parsed = parseArgs(args);
   const question = sanitizeQuestion(parsed.rest.join(" "));
   if (!question) {
     return USAGE;
   }
-  const config3 = loadPluginConfig(directory);
-  if (config3.council?.general?.enabled !== true) {
-    return [
-      "General Council is not enabled for this project.",
-      "",
-      "Enable it in `.opencode/opencode-swarm.json` or `~/.config/opencode/opencode-swarm.json`:",
-      "",
-      "```json",
-      "{",
-      '  "council": {',
-      '    "general": { "enabled": true }',
-      "  }",
-      "}",
-      "```",
-      "",
-      "Then restart OpenCode and run `/swarm config doctor` before trying `/swarm council` again."
-    ].join(`
-`);
-  }
   const tokens = ["MODE: COUNCIL"];
   if (parsed.preset) {
     tokens.push(`preset=${parsed.preset}`);
@@ -38292,7 +38401,6 @@ async function handleCouncilCommand(directory, args) {
 }
 var MAX_QUESTION_LEN = 2000, USAGE;
 var init_council = __esm(() => {
-  init_loader();
   USAGE = [
     "Usage: /swarm council <question> [--preset <name>] [--spec-review]",
     "",
@@ -39769,7 +39877,6 @@ __export(exports_config_doctor, {
   restoreFromBackup: () => restoreFromBackup,
   getConfigPaths: () => getConfigPaths,
   createConfigBackup: () => createConfigBackup,
-  collectConfiguredModelRefs: () => collectConfiguredModelRefs,
   applySafeAutoFixes: () => applySafeAutoFixes
 });
 import * as crypto3 from "crypto";
@@ -40163,129 +40270,6 @@ function validateConfigKey(path24, value, _config) {
   }
   return findings;
 }
-function addConfiguredModel(refs, model, configPath) {
-  if (typeof model !== "string")
-    return;
-  const trimmed = model.trim();
-  if (!trimmed)
-    return;
-  const paths = refs.get(trimmed) ?? new Set;
-  paths.add(configPath);
-  refs.set(trimmed, paths);
-}
-function addConfiguredAgentModels(refs, agents, prefix) {
-  if (!agents || typeof agents !== "object" || Array.isArray(agents))
-    return;
-  for (const [agentName, value] of Object.entries(agents)) {
-    if (!value || typeof value !== "object" || Array.isArray(value))
-      continue;
-    const agent = value;
-    addConfiguredModel(refs, agent.model, `${prefix}.${agentName}.model`);
-    if (Array.isArray(agent.fallback_models)) {
-      agent.fallback_models.forEach((model, index) => {
-        addConfiguredModel(refs, model, `${prefix}.${agentName}.fallback_models[${index}]`);
-      });
-    }
-  }
-}
-function collectConfiguredModelRefs(config3) {
-  const refs = new Map;
-  const rawConfig = config3;
-  addConfiguredAgentModels(refs, rawConfig.agents, "agents");
-  if (rawConfig.swarms && typeof rawConfig.swarms === "object" && !Array.isArray(rawConfig.swarms)) {
-    for (const [swarmId, value] of Object.entries(rawConfig.swarms)) {
-      if (!value || typeof value !== "object" || Array.isArray(value))
-        continue;
-      addConfiguredAgentModels(refs, value.agents, `swarms.${swarmId}.agents`);
-    }
-  }
-  if (rawConfig.full_auto && typeof rawConfig.full_auto === "object" && !Array.isArray(rawConfig.full_auto)) {
-    addConfiguredModel(refs, rawConfig.full_auto.critic_model, "full_auto.critic_model");
-  }
-  if (rawConfig.skill_improver && typeof rawConfig.skill_improver === "object" && !Array.isArray(rawConfig.skill_improver)) {
-    const skillImprover = rawConfig.skill_improver;
-    addConfiguredModel(refs, skillImprover.model, "skill_improver.model");
-    if (Array.isArray(skillImprover.fallback_models)) {
-      skillImprover.fallback_models.forEach((model, index) => {
-        addConfiguredModel(refs, model, `skill_improver.fallback_models[${index}]`);
-      });
-    }
-  }
-  if (rawConfig.spec_writer && typeof rawConfig.spec_writer === "object" && !Array.isArray(rawConfig.spec_writer)) {
-    const specWriter = rawConfig.spec_writer;
-    addConfiguredModel(refs, specWriter.model, "spec_writer.model");
-    if (Array.isArray(specWriter.fallback_models)) {
-      specWriter.fallback_models.forEach((model, index) => {
-        addConfiguredModel(refs, model, `spec_writer.fallback_models[${index}]`);
-      });
-    }
-  }
-  const council = rawConfig.council;
-  const general = council && typeof council === "object" && !Array.isArray(council) ? council.general : undefined;
-  if (general && typeof general === "object" && !Array.isArray(general)) {
-    addConfiguredModel(refs, general.moderatorModel, "council.general.moderatorModel");
-    if (Array.isArray(general.members)) {
-      general.members.forEach((member, index) => {
-        if (!member || typeof member !== "object" || Array.isArray(member)) {
-          return;
-        }
-        addConfiguredModel(refs, member.model, `council.general.members[${index}].model`);
-      });
-    }
-    if (general.presets && typeof general.presets === "object" && !Array.isArray(general.presets)) {
-      for (const [presetName, members] of Object.entries(general.presets)) {
-        if (!Array.isArray(members))
-          continue;
-        members.forEach((member, index) => {
-          if (!member || typeof member !== "object" || Array.isArray(member)) {
-            return;
-          }
-          addConfiguredModel(refs, member.model, `council.general.presets.${presetName}[${index}].model`);
-        });
-      }
-    }
-  }
-  return refs;
-}
-function validateConfiguredModels(config3, modelAvailability) {
-  const refs = collectConfiguredModelRefs(config3);
-  const findings = [];
-  if (modelAvailability.error) {
-    findings.push({
-      id: "model-availability-unchecked",
-      title: "Model availability check skipped",
-      description: `Could not load OpenCode provider models from ${modelAvailability.source}: ` + modelAvailability.error,
-      severity: "info",
-      path: "agents",
-      autoFixable: false
-    });
-    return findings;
-  }
-  if (refs.size === 0)
-    return findings;
-  for (const [modelId, paths] of refs.entries()) {
-    if (modelAvailability.availableModelIds.has(modelId))
-      continue;
-    findings.push({
-      id: "configured-model-unavailable",
-      title: "Configured model is unavailable",
-      description: `Configured model ${formatModelIdForDoctor(modelId)} was not found in the active OpenCode provider model registry. ` + "Run `/models` to choose a currently available model, then update opencode-swarm.json.",
-      severity: "error",
-      path: [...paths].sort().join(", "),
-      currentValue: modelId,
-      autoFixable: false
-    });
-  }
-  return findings;
-}
-function formatModelIdForDoctor(modelId) {
-  const json3 = JSON.stringify(modelId);
-  if (!json3)
-    return '"<invalid model id>"';
-  if (json3.length <= 160)
-    return json3;
-  return `${json3.slice(0, 157)}..."`;
-}
 function walkConfigAndValidate(obj, path24, config3, findings) {
   if (obj === null || obj === undefined) {
     return;
@@ -40310,12 +40294,9 @@ function walkConfigAndValidate(obj, path24, config3, findings) {
     walkConfigAndValidate(value, newPath, config3, findings);
   }
 }
-function runConfigDoctor(config3, directory, options = {}) {
+function runConfigDoctor(config3, directory) {
   const findings = [];
   walkConfigAndValidate(config3, "", config3, findings);
-  if (options.modelAvailability) {
-    findings.push(...validateConfiguredModels(config3, options.modelAvailability));
-  }
   const summary = {
     info: findings.filter((f) => f.severity === "info").length,
     warn: findings.filter((f) => f.severity === "warn").length,
@@ -40477,8 +40458,8 @@ function shouldRunOnStartup(automationConfig) {
   }
   return automationConfig.capabilities?.config_doctor_on_startup === true;
 }
-async function runConfigDoctorWithFixes(directory, config3, autoFix = false, options = {}) {
-  const result = runConfigDoctor(config3, directory, options);
+async function runConfigDoctorWithFixes(directory, config3, autoFix = false) {
+  const result = runConfigDoctor(config3, directory);
   const artifactPath = writeDoctorArtifact(directory, result);
   if (!autoFix) {
     return {
@@ -40498,7 +40479,7 @@ async function runConfigDoctorWithFixes(directory, config3, autoFix = false, opt
   if (appliedFixes.length > 0) {
     const freshConfig = readConfigFromFile(directory);
     if (freshConfig) {
-      const newResult = runConfigDoctor(freshConfig.config, directory, options);
+      const newResult = runConfigDoctor(freshConfig.config, directory);
       writeDoctorArtifact(directory, newResult);
     }
   }
@@ -42120,23 +42101,6 @@ var init_tool_doctor = __esm(() => {
   ];
 });
 
-// src/utils/timeout.ts
-async function withTimeout(promise3, ms, timeoutError) {
-  let timer;
-  const timeoutPromise = new Promise((_, reject) => {
-    timer = setTimeout(() => reject(timeoutError), ms);
-    if (typeof timer.unref === "function") {
-      timer.unref();
-    }
-  });
-  try {
-    return await Promise.race([promise3, timeoutPromise]);
-  } finally {
-    if (timer !== undefined)
-      clearTimeout(timer);
-  }
-}
-
 // src/commands/doctor.ts
 function formatToolDoctorMarkdown(result) {
   const lines = [
@@ -42210,67 +42174,13 @@ function formatDoctorMarkdown(result) {
   return lines.join(`
 `);
 }
-function extractAvailableModelIds(response) {
-  const available = new Set;
-  if (response?.providers !== undefined && !Array.isArray(response.providers)) {
-    throw new Error("provider registry returned malformed provider list");
-  }
-  for (const provider of response?.providers ?? []) {
-    if (!provider || typeof provider !== "object" || !provider.id || !provider.models || typeof provider.models !== "object" || Array.isArray(provider.models)) {
-      continue;
-    }
-    for (const [modelKey, modelInfo] of Object.entries(provider.models)) {
-      available.add(`${provider.id}/${modelKey}`);
-      if (modelInfo && typeof modelInfo === "object" && modelInfo.id) {
-        available.add(`${provider.id}/${modelInfo.id}`);
-      }
-    }
-  }
-  return available;
-}
-async function loadModelAvailability(directory, client, options = {}) {
-  const providerClient = client;
-  const providers = providerClient?.config?.providers;
-  if (typeof providers !== "function") {
-    return;
-  }
-  try {
-    const response = await withTimeout(providers({ directory }), options.timeoutMs ?? MODEL_REGISTRY_TIMEOUT_MS, new Error(`OpenCode provider model registry lookup exceeded ${options.timeoutMs ?? MODEL_REGISTRY_TIMEOUT_MS}ms`));
-    if (response.error) {
-      return {
-        availableModelIds: new Set,
-        source: MODEL_REGISTRY_SOURCE,
-        error: typeof response.error === "string" ? response.error : JSON.stringify(response.error)
-      };
-    }
-    if (!response.data) {
-      return {
-        availableModelIds: new Set,
-        source: MODEL_REGISTRY_SOURCE,
-        error: "provider registry returned no data"
-      };
-    }
-    return {
-      availableModelIds: extractAvailableModelIds(response.data),
-      source: MODEL_REGISTRY_SOURCE
-    };
-  } catch (error93) {
-    return {
-      availableModelIds: new Set,
-      source: MODEL_REGISTRY_SOURCE,
-      error: error93 instanceof Error ? error93.message : String(error93)
-    };
-  }
-}
-async function handleDoctorCommand(directory, args, options = {}) {
+async function handleDoctorCommand(directory, args) {
   const enableAutoFix = args.includes("--fix") || args.includes("-f");
   const config3 = loadPluginConfig(directory);
-  const modelAvailability = await loadModelAvailability(directory, options.client);
-  const doctorOptions = { modelAvailability };
-  const result = runConfigDoctor(config3, directory, doctorOptions);
+  const result = runConfigDoctor(config3, directory);
   if (enableAutoFix && result.hasAutoFixableIssues) {
     const { runConfigDoctorWithFixes: runConfigDoctorWithFixes2 } = await Promise.resolve().then(() => (init_config_doctor(), exports_config_doctor));
-    const fixResult = await runConfigDoctorWithFixes2(directory, config3, true, doctorOptions);
+    const fixResult = await runConfigDoctorWithFixes2(directory, config3, true);
     return formatDoctorMarkdown(fixResult.result);
   }
   return formatDoctorMarkdown(result);
@@ -42279,7 +42189,6 @@ async function handleDoctorToolsCommand(directory, _args) {
   const result = runToolDoctor(directory);
   return formatToolDoctorMarkdown(result);
 }
-var MODEL_REGISTRY_TIMEOUT_MS = 3000, MODEL_REGISTRY_SOURCE = "OpenCode config.providers";
 var init_doctor = __esm(() => {
   init_loader();
   init_config_doctor();
@@ -42620,7 +42529,7 @@ function getVerdictEmoji(verdict) {
   return getVerdictIcon(verdict);
 }
 async function getTaskEvidenceData(directory, taskId) {
-  const result = await loadEvidence(directory, taskId);
+  const result = await _internals13.loadEvidence(directory, taskId);
   if (result.status !== "found") {
     return {
       hasEvidence: false,
@@ -42643,13 +42552,13 @@ async function getTaskEvidenceData(directory, taskId) {
   };
 }
 async function getEvidenceListData(directory) {
-  const taskIds = await listEvidenceTaskIds(directory);
+  const taskIds = await _internals13.listEvidenceTaskIds(directory);
   if (taskIds.length === 0) {
     return { hasEvidence: false, tasks: [] };
   }
   const tasks = [];
   for (const taskId of taskIds) {
-    const result = await loadEvidence(directory, taskId);
+    const result = await _internals13.loadEvidence(directory, taskId);
     if (result.status === "found") {
       tasks.push({
         taskId,
@@ -42763,8 +42672,13 @@ async function handleEvidenceSummaryCommand(directory) {
   return lines.join(`
 `);
 }
+var _internals13;
 var init_evidence_service = __esm(() => {
   init_manager2();
+  _internals13 = {
+    loadEvidence,
+    listEvidenceTaskIds
+  };
 });
 
 // src/commands/evidence.ts
@@ -43168,7 +43082,7 @@ function extractCurrentPhaseFromPlan2(plan) {
   if (!plan) {
     return { currentPhase: null, currentTask: null, incompleteTasks: [] };
   }
-  if (!_internals13.validatePlanPhases(plan)) {
+  if (!_internals14.validatePlanPhases(plan)) {
     return { currentPhase: null, currentTask: null, incompleteTasks: [] };
   }
   let currentPhase = null;
@@ -43310,9 +43224,9 @@ function extractPhaseMetrics(content) {
 async function getHandoffData(directory) {
   const now = new Date().toISOString();
   const sessionContent = await readSwarmFileAsync(directory, "session/state.json");
-  const sessionState = _internals13.parseSessionState(sessionContent);
+  const sessionState = _internals14.parseSessionState(sessionContent);
   const plan = await loadPlanJsonOnly(directory);
-  const planInfo = _internals13.extractCurrentPhaseFromPlan(plan);
+  const planInfo = _internals14.extractCurrentPhaseFromPlan(plan);
   if (!plan) {
     const planMdContent = await readSwarmFileAsync(directory, "plan.md");
     if (planMdContent) {
@@ -43331,8 +43245,8 @@ async function getHandoffData(directory) {
     }
   }
   const contextContent = await readSwarmFileAsync(directory, "context.md");
-  const recentDecisions = _internals13.extractDecisions(contextContent);
-  const rawPhaseMetrics = _internals13.extractPhaseMetrics(contextContent);
+  const recentDecisions = _internals14.extractDecisions(contextContent);
+  const rawPhaseMetrics = _internals14.extractPhaseMetrics(contextContent);
   const phaseMetrics = sanitizeString(rawPhaseMetrics, 1000);
   let delegationState = null;
   if (sessionState?.delegationState) {
@@ -43496,13 +43410,13 @@ ${lines.join(`
 `)}
 \`\`\``;
 }
-var RTL_OVERRIDE_PATTERN, MAX_TASK_ID_LENGTH = 100, MAX_DECISION_LENGTH = 500, MAX_INCOMPLETE_TASKS = 20, _internals13;
+var RTL_OVERRIDE_PATTERN, MAX_TASK_ID_LENGTH = 100, MAX_DECISION_LENGTH = 500, MAX_INCOMPLETE_TASKS = 20, _internals14;
 var init_handoff_service = __esm(() => {
   init_utils2();
   init_manager();
   init_utils();
   RTL_OVERRIDE_PATTERN = /[\u202e\u202d\u202c\u200f]/g;
-  _internals13 = {
+  _internals14 = {
     getHandoffData,
     formatHandoffMarkdown,
     formatContinuationPrompt,
@@ -43621,22 +43535,22 @@ async function writeSnapshot(directory, state) {
 }
 function createSnapshotWriterHook(directory) {
   return (_input, _output) => {
-    _writeInFlight = _writeInFlight.then(() => _internals14.writeSnapshot(directory, swarmState), () => _internals14.writeSnapshot(directory, swarmState));
+    _writeInFlight = _writeInFlight.then(() => _internals15.writeSnapshot(directory, swarmState), () => _internals15.writeSnapshot(directory, swarmState));
     return _writeInFlight;
   };
 }
 async function flushPendingSnapshot(directory) {
-  _writeInFlight = _writeInFlight.then(() => _internals14.writeSnapshot(directory, swarmState), () => _internals14.writeSnapshot(directory, swarmState));
+  _writeInFlight = _writeInFlight.then(() => _internals15.writeSnapshot(directory, swarmState), () => _internals15.writeSnapshot(directory, swarmState));
   await _writeInFlight;
 }
-var _writeInFlight, _internals14;
+var _writeInFlight, _internals15;
 var init_snapshot_writer = __esm(() => {
   init_utils2();
   init_state();
   init_utils();
   init_bun_compat();
   _writeInFlight = Promise.resolve();
-  _internals14 = {
+  _internals15 = {
     writeSnapshot,
     createSnapshotWriterHook,
     flushPendingSnapshot
@@ -44101,9 +44015,9 @@ async function migrateContextToKnowledge(directory, config3) {
       skippedReason: "empty-context"
     };
   }
-  const rawEntries = _internals15.parseContextMd(contextContent);
+  const rawEntries = _internals16.parseContextMd(contextContent);
   if (rawEntries.length === 0) {
-    await _internals15.writeSentinel(sentinelPath, 0, 0);
+    await _internals16.writeSentinel(sentinelPath, 0, 0);
     return {
       migrated: true,
       entriesMigrated: 0,
@@ -44114,10 +44028,10 @@ async function migrateContextToKnowledge(directory, config3) {
   const existing = await readKnowledge(knowledgePath);
   let migrated = 0;
   let dropped = 0;
-  const projectName = _internals15.inferProjectName(directory);
+  const projectName = _internals16.inferProjectName(directory);
   for (const raw of rawEntries) {
     if (config3.validation_enabled !== false) {
-      const category = raw.categoryHint ?? _internals15.inferCategoryFromText(raw.text);
+      const category = raw.categoryHint ?? _internals16.inferCategoryFromText(raw.text);
       const result = validateLesson(raw.text, existing.map((e) => e.lesson), {
         category,
         scope: "global",
@@ -44137,8 +44051,8 @@ async function migrateContextToKnowledge(directory, config3) {
     const entry = {
       id: randomUUID2(),
       tier: "swarm",
-      lesson: _internals15.truncateLesson(raw.text),
-      category: raw.categoryHint ?? _internals15.inferCategoryFromText(raw.text),
+      lesson: _internals16.truncateLesson(raw.text),
+      category: raw.categoryHint ?? _internals16.inferCategoryFromText(raw.text),
       tags: [...inferredTags, `migration:${raw.sourceSection}`],
       scope: "global",
       confidence: 0.3,
@@ -44161,7 +44075,7 @@ async function migrateContextToKnowledge(directory, config3) {
   if (migrated > 0) {
     await rewriteKnowledge(knowledgePath, existing);
   }
-  await _internals15.writeSentinel(sentinelPath, migrated, dropped);
+  await _internals16.writeSentinel(sentinelPath, migrated, dropped);
   log(`[knowledge-migrator] Migrated ${migrated} entries, dropped ${dropped}`);
   return {
     migrated: true,
@@ -44171,7 +44085,7 @@ async function migrateContextToKnowledge(directory, config3) {
   };
 }
 function parseContextMd(content) {
-  const sections = _internals15.splitIntoSections(content);
+  const sections = _internals16.splitIntoSections(content);
   const entries = [];
   const seen = new Set;
   const sectionPatterns = [
@@ -44187,7 +44101,7 @@ function parseContextMd(content) {
     const match = sectionPatterns.find((sp) => sp.pattern.test(section.heading));
     if (!match)
       continue;
-    const bullets = _internals15.extractBullets(section.body);
+    const bullets = _internals16.extractBullets(section.body);
     for (const bullet of bullets) {
       if (bullet.length < 15)
         continue;
@@ -44196,9 +44110,9 @@ function parseContextMd(content) {
         continue;
       seen.add(normalized);
       entries.push({
-        text: _internals15.truncateLesson(bullet),
+        text: _internals16.truncateLesson(bullet),
         sourceSection: match.sourceSection,
-        categoryHint: _internals15.inferCategoryFromText(bullet)
+        categoryHint: _internals16.inferCategoryFromText(bullet)
       });
     }
   }
@@ -44291,12 +44205,12 @@ async function writeSentinel(sentinelPath, migrated, dropped) {
   await mkdir8(path28.dirname(sentinelPath), { recursive: true });
   await writeFile9(sentinelPath, JSON.stringify(sentinel, null, 2), "utf-8");
 }
-var _internals15;
+var _internals16;
 var init_knowledge_migrator = __esm(() => {
   init_logger();
   init_knowledge_store();
   init_knowledge_validator();
-  _internals15 = {
+  _internals16 = {
     migrateContextToKnowledge,
     migrateKnowledgeToExternal,
     parseContextMd,
@@ -44433,9 +44347,9 @@ var init_knowledge = __esm(() => {
 
 // src/services/plan-service.ts
 async function getPlanData(directory, phaseArg) {
-  const plan = await loadPlanJsonOnly(directory);
+  const plan = await _internals17.loadPlanJsonOnly(directory);
   if (plan) {
-    const fullMarkdown = derivePlanMarkdown(plan);
+    const fullMarkdown = _internals17.derivePlanMarkdown(plan);
     if (phaseArg === undefined || phaseArg === null || phaseArg === "") {
       return {
         hasPlan: true,
@@ -44478,7 +44392,7 @@ async function getPlanData(directory, phaseArg) {
       isLegacy: false
     };
   }
-  const planContent = await readSwarmFileAsync(directory, "plan.md");
+  const planContent = await _internals17.readSwarmFileAsync(directory, "plan.md");
   if (!planContent) {
     return {
       hasPlan: false,
@@ -44574,9 +44488,15 @@ async function handlePlanCommand(directory, args) {
   const planData = await getPlanData(directory, phaseArg);
   return formatPlanMarkdown(planData);
 }
+var _internals17;
 var init_plan_service = __esm(() => {
   init_utils2();
   init_manager();
+  _internals17 = {
+    loadPlanJsonOnly,
+    derivePlanMarkdown,
+    readSwarmFileAsync
+  };
 });
 
 // src/commands/plan.ts
@@ -45162,7 +45082,7 @@ async function runAdditionalLint(linter, mode, cwd) {
     };
   }
 }
-var MAX_OUTPUT_BYTES = 512000, MAX_COMMAND_LENGTH = 500, lint, _internals16;
+var MAX_OUTPUT_BYTES = 512000, MAX_COMMAND_LENGTH = 500, lint, _internals18;
 var init_lint = __esm(() => {
   init_zod();
   init_discovery();
@@ -45194,15 +45114,15 @@ var init_lint = __esm(() => {
       }
       const { mode } = args;
       const cwd = directory;
-      const linter = await _internals16.detectAvailableLinter(directory);
+      const linter = await _internals18.detectAvailableLinter(directory);
       if (linter) {
-        const result = await _internals16.runLint(linter, mode, directory);
+        const result = await _internals18.runLint(linter, mode, directory);
         return JSON.stringify(result, null, 2);
       }
-      const additionalLinter = _internals16.detectAdditionalLinter(cwd);
+      const additionalLinter = _internals18.detectAdditionalLinter(cwd);
       if (additionalLinter) {
         warn(`[lint] Using ${additionalLinter} linter for this project`);
-        const result = await _internals16.runAdditionalLint(additionalLinter, mode, cwd);
+        const result = await _internals18.runAdditionalLint(additionalLinter, mode, cwd);
         return JSON.stringify(result, null, 2);
       }
       const errorResult = {
@@ -45216,7 +45136,7 @@ For Rust: rustup component add clippy`
       return JSON.stringify(errorResult, null, 2);
     }
   });
-  _internals16 = {
+  _internals18 = {
     detectAvailableLinter,
     runLint,
     detectAdditionalLinter,
@@ -45530,7 +45450,7 @@ function findScannableFiles(dir, excludeExact, excludeGlobs, scanDir, visited, s
 }
 async function runSecretscan(directory) {
   try {
-    const result = await _internals17.secretscan.execute({ directory }, {});
+    const result = await _internals19.secretscan.execute({ directory }, {});
     const jsonStr = typeof result === "string" ? result : result.output;
     return JSON.parse(jsonStr);
   } catch (e) {
@@ -45545,7 +45465,7 @@ async function runSecretscan(directory) {
     return errorResult;
   }
 }
-var MAX_FILE_PATH_LENGTH = 500, MAX_FILE_SIZE_BYTES, MAX_FILES_SCANNED = 1000, MAX_FINDINGS = 100, MAX_OUTPUT_BYTES2 = 512000, MAX_LINE_LENGTH = 1e4, MAX_CONTENT_BYTES, BINARY_SIGNATURES, BINARY_PREFIX_BYTES = 4, BINARY_NULL_CHECK_BYTES = 8192, BINARY_NULL_THRESHOLD = 0.1, DEFAULT_EXCLUDE_DIRS, DEFAULT_EXCLUDE_EXTENSIONS, SECRET_PATTERNS, O_NOFOLLOW, secretscan, _internals17;
+var MAX_FILE_PATH_LENGTH = 500, MAX_FILE_SIZE_BYTES, MAX_FILES_SCANNED = 1000, MAX_FINDINGS = 100, MAX_OUTPUT_BYTES2 = 512000, MAX_LINE_LENGTH = 1e4, MAX_CONTENT_BYTES, BINARY_SIGNATURES, BINARY_PREFIX_BYTES = 4, BINARY_NULL_CHECK_BYTES = 8192, BINARY_NULL_THRESHOLD = 0.1, DEFAULT_EXCLUDE_DIRS, DEFAULT_EXCLUDE_EXTENSIONS, SECRET_PATTERNS, O_NOFOLLOW, secretscan, _internals19;
 var init_secretscan = __esm(() => {
   init_zod();
   init_path_security();
@@ -45917,7 +45837,7 @@ var init_secretscan = __esm(() => {
       }
     }
   });
-  _internals17 = {
+  _internals19 = {
     secretscan,
     runSecretscan
   };
@@ -46489,14 +46409,14 @@ function buildGoBackend() {
     selectEntryPoints
   };
 }
-var PROFILE_ID = "go", IMPORT_REGEX_SINGLE, IMPORT_REGEX_GROUP, IMPORT_REGEX_GROUP_LINE, _internals18;
+var PROFILE_ID = "go", IMPORT_REGEX_SINGLE, IMPORT_REGEX_GROUP, IMPORT_REGEX_GROUP_LINE, _internals20;
 var init_go = __esm(() => {
   init_default_backend();
   init_profiles();
   IMPORT_REGEX_SINGLE = /^\s*import\s+(?:[a-zA-Z_.][a-zA-Z0-9_]*\s+)?"([^"]+)"/gm;
   IMPORT_REGEX_GROUP = /^\s*import\s*\(([\s\S]*?)\)/gm;
   IMPORT_REGEX_GROUP_LINE = /(?:[a-zA-Z_.][a-zA-Z0-9_]*\s+)?"([^"]+)"/g;
-  _internals18 = { extractImports };
+  _internals20 = { extractImports };
 });
 
 // src/lang/backends/python.ts
@@ -46608,13 +46528,13 @@ function buildPythonBackend() {
     selectEntryPoints: selectEntryPoints2
   };
 }
-var PROFILE_ID2 = "python", IMPORT_REGEX_FROM_WITH_TARGETS, IMPORT_REGEX_IMPORT, _internals19;
+var PROFILE_ID2 = "python", IMPORT_REGEX_FROM_WITH_TARGETS, IMPORT_REGEX_IMPORT, _internals21;
 var init_python = __esm(() => {
   init_default_backend();
   init_profiles();
   IMPORT_REGEX_FROM_WITH_TARGETS = /^\s*from\s+(\.*[\w.]*)\s+import\s+(\([^)]*\)|[^\n#]+)/gm;
   IMPORT_REGEX_IMPORT = /^\s*import\s+([^\n#]+)/gm;
-  _internals19 = { extractImports: extractImports2 };
+  _internals21 = { extractImports: extractImports2 };
 });
 
 // src/test-impact/analyzer.ts
@@ -46825,7 +46745,7 @@ function addImpactEdgesForTestFile(testFile, content, impactMap) {
     return;
   }
   if (PYTHON_EXTENSIONS.has(ext)) {
-    const modules = _internals19.extractImports(testFile, content);
+    const modules = _internals21.extractImports(testFile, content);
     for (const mod of modules) {
       const resolved = resolvePythonImport(testDir, mod);
       if (resolved !== null)
@@ -46834,7 +46754,7 @@ function addImpactEdgesForTestFile(testFile, content, impactMap) {
     return;
   }
   if (GO_EXTENSIONS.has(ext)) {
-    const imports = _internals18.extractImports(testFile, content);
+    const imports = _internals20.extractImports(testFile, content);
     for (const importPath of imports) {
       const sourceFiles = resolveGoImport(testDir, importPath);
       for (const source of sourceFiles)
@@ -46861,8 +46781,8 @@ async function buildImpactMapInternal(cwd) {
   return impactMap;
 }
 async function buildImpactMap(cwd) {
-  const impactMap = await _internals20.buildImpactMapInternal(cwd);
-  await _internals20.saveImpactMap(cwd, impactMap);
+  const impactMap = await _internals22.buildImpactMapInternal(cwd);
+  await _internals22.saveImpactMap(cwd, impactMap);
   return impactMap;
 }
 async function loadImpactMap(cwd) {
@@ -46873,12 +46793,12 @@ async function loadImpactMap(cwd) {
       const data = JSON.parse(content);
       const map3 = data.map;
       const generatedAt = new Date(data.generatedAt).getTime();
-      if (!_internals20.isCacheStale(map3, generatedAt)) {
+      if (!_internals22.isCacheStale(map3, generatedAt)) {
         return map3;
       }
     } catch {}
   }
-  return _internals20.buildImpactMap(cwd);
+  return _internals22.buildImpactMap(cwd);
 }
 async function saveImpactMap(cwd, impactMap) {
   const cacheDir2 = path34.join(cwd, ".swarm", "cache");
@@ -46904,7 +46824,7 @@ async function analyzeImpact(changedFiles, cwd) {
     };
   }
   const validFiles = changedFiles.filter((f) => typeof f === "string" && f.length > 0 && !f.includes("\x00"));
-  const impactMap = await _internals20.loadImpactMap(cwd);
+  const impactMap = await _internals22.loadImpactMap(cwd);
   const impactedTestsSet = new Set;
   const untestedFiles = [];
   for (const changedFile of validFiles) {
@@ -46945,7 +46865,7 @@ async function analyzeImpact(changedFiles, cwd) {
     impactMap
   };
 }
-var IMPORT_REGEX_ES, IMPORT_REGEX_REQUIRE, IMPORT_REGEX_REEXPORT, TS_EXTENSIONS, PYTHON_EXTENSIONS, GO_EXTENSIONS, EXTENSIONS_TO_TRY, goModuleCache, _internals20;
+var IMPORT_REGEX_ES, IMPORT_REGEX_REQUIRE, IMPORT_REGEX_REEXPORT, TS_EXTENSIONS, PYTHON_EXTENSIONS, GO_EXTENSIONS, EXTENSIONS_TO_TRY, goModuleCache, _internals22;
 var init_analyzer = __esm(() => {
   init_go();
   init_python();
@@ -46957,7 +46877,7 @@ var init_analyzer = __esm(() => {
   GO_EXTENSIONS = new Set([".go"]);
   EXTENSIONS_TO_TRY = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"];
   goModuleCache = new Map;
-  _internals20 = {
+  _internals22 = {
     normalizePath,
     isCacheStale,
     resolveRelativeImport,
@@ -47437,7 +47357,7 @@ function readPackageJsonRaw(dir) {
   }
 }
 function readPackageJson(dir) {
-  return _internals21.readPackageJsonRaw(dir);
+  return _internals23.readPackageJsonRaw(dir);
 }
 function readPackageJsonTestScript(dir) {
   return readPackageJson(dir)?.scripts?.test ?? null;
@@ -47607,7 +47527,7 @@ function buildTypescriptBackend() {
     selectEntryPoints: selectEntryPoints3
   };
 }
-var PROFILE_ID3 = "typescript", IMPORT_REGEX_ES2, IMPORT_REGEX_BARE, IMPORT_REGEX_REQUIRE2, IMPORT_REGEX_DYNAMIC, IMPORT_REGEX_REEXPORT2, _internals21;
+var PROFILE_ID3 = "typescript", IMPORT_REGEX_ES2, IMPORT_REGEX_BARE, IMPORT_REGEX_REQUIRE2, IMPORT_REGEX_DYNAMIC, IMPORT_REGEX_REEXPORT2, _internals23;
 var init_typescript = __esm(() => {
   init_default_backend();
   init_profiles();
@@ -47616,7 +47536,7 @@ var init_typescript = __esm(() => {
   IMPORT_REGEX_REQUIRE2 = /require\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
   IMPORT_REGEX_DYNAMIC = /import\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
   IMPORT_REGEX_REEXPORT2 = /export\s+(?:\{[^}]*\}|\*)\s+from\s+['"]([^'"]+)['"]/g;
-  _internals21 = {
+  _internals23 = {
     readPackageJsonRaw,
     readPackageJsonTestScript,
     frameworkFromScriptsTest
@@ -47647,7 +47567,7 @@ __export(exports_dispatch, {
   pickedProfiles: () => pickedProfiles,
   pickBackend: () => pickBackend,
   clearDispatchCache: () => clearDispatchCache,
-  _internals: () => _internals22
+  _internals: () => _internals24
 });
 import * as fs21 from "fs";
 import * as path38 from "path";
@@ -47702,7 +47622,7 @@ function findManifestRoot(start) {
   return start;
 }
 function evictIfNeeded() {
-  if (cache.size <= _internals22.cacheCapacity)
+  if (cache.size <= _internals24.cacheCapacity)
     return;
   let oldestKey;
   let oldestOrder = Infinity;
@@ -47733,7 +47653,7 @@ async function pickBackend(dir) {
     evictIfNeeded();
     return null;
   }
-  const profiles = await _internals22.detectProjectLanguages(root);
+  const profiles = await _internals24.detectProjectLanguages(root);
   if (profiles.length === 0) {
     cache.set(cacheKey, {
       hash: hash3,
@@ -47765,12 +47685,12 @@ function clearDispatchCache() {
   manifestRootCache.clear();
   insertCounter = 0;
 }
-var _internals22, cache, insertCounter = 0, MANIFEST_FILES, _MANIFEST_SET, manifestRootCache;
+var _internals24, cache, insertCounter = 0, MANIFEST_FILES, _MANIFEST_SET, manifestRootCache;
 var init_dispatch = __esm(() => {
   init_backends();
   init_detector();
   init_registry_backend();
-  _internals22 = {
+  _internals24 = {
     detectProjectLanguages,
     cacheCapacity: 64
   };
@@ -49307,9 +49227,9 @@ function getVersionFileVersion(dir) {
 async function runVersionCheck(dir, _timeoutMs) {
   const startTime = Date.now();
   try {
-    const packageVersion = _internals23.getPackageVersion(dir);
-    const changelogVersion = _internals23.getChangelogVersion(dir);
-    const versionFileVersion = _internals23.getVersionFileVersion(dir);
+    const packageVersion = _internals25.getPackageVersion(dir);
+    const changelogVersion = _internals25.getChangelogVersion(dir);
+    const versionFileVersion = _internals25.getVersionFileVersion(dir);
     const versions3 = [];
     if (packageVersion)
       versions3.push(`package.json: ${packageVersion}`);
@@ -49659,7 +49579,7 @@ async function runPreflight(dir, phase, config3) {
   const reportId = `preflight-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
   let validatedDir;
   try {
-    validatedDir = _internals23.validateDirectoryPath(dir);
+    validatedDir = _internals25.validateDirectoryPath(dir);
   } catch (error93) {
     return {
       id: reportId,
@@ -49679,7 +49599,7 @@ async function runPreflight(dir, phase, config3) {
   }
   let validatedTimeout;
   try {
-    validatedTimeout = _internals23.validateTimeout(config3?.checkTimeoutMs, DEFAULT_CONFIG.checkTimeoutMs);
+    validatedTimeout = _internals25.validateTimeout(config3?.checkTimeoutMs, DEFAULT_CONFIG.checkTimeoutMs);
   } catch (error93) {
     return {
       id: reportId,
@@ -49720,12 +49640,12 @@ async function runPreflight(dir, phase, config3) {
   });
   const checks5 = [];
   log("[Preflight] Running lint check...");
-  const lintResult = await _internals23.runLintCheck(validatedDir, cfg.linter, cfg.checkTimeoutMs);
+  const lintResult = await _internals25.runLintCheck(validatedDir, cfg.linter, cfg.checkTimeoutMs);
   checks5.push(lintResult);
   log(`[Preflight] Lint check: ${lintResult.status} ${lintResult.message}`);
   if (!cfg.skipTests) {
     log("[Preflight] Running tests check...");
-    const testsResult = await _internals23.runTestsCheck(validatedDir, cfg.testScope, cfg.checkTimeoutMs);
+    const testsResult = await _internals25.runTestsCheck(validatedDir, cfg.testScope, cfg.checkTimeoutMs);
     checks5.push(testsResult);
     log(`[Preflight] Tests check: ${testsResult.status} ${testsResult.message}`);
   } else {
@@ -49737,7 +49657,7 @@ async function runPreflight(dir, phase, config3) {
   }
   if (!cfg.skipSecrets) {
     log("[Preflight] Running secrets check...");
-    const secretsResult = await _internals23.runSecretsCheck(validatedDir, cfg.checkTimeoutMs);
+    const secretsResult = await _internals25.runSecretsCheck(validatedDir, cfg.checkTimeoutMs);
     checks5.push(secretsResult);
     log(`[Preflight] Secrets check: ${secretsResult.status} ${secretsResult.message}`);
   } else {
@@ -49749,7 +49669,7 @@ async function runPreflight(dir, phase, config3) {
   }
   if (!cfg.skipEvidence) {
     log("[Preflight] Running evidence check...");
-    const evidenceResult = await _internals23.runEvidenceCheck(validatedDir);
+    const evidenceResult = await _internals25.runEvidenceCheck(validatedDir);
     checks5.push(evidenceResult);
     log(`[Preflight] Evidence check: ${evidenceResult.status} ${evidenceResult.message}`);
   } else {
@@ -49760,12 +49680,12 @@ async function runPreflight(dir, phase, config3) {
     });
   }
   log("[Preflight] Running requirement coverage check...");
-  const reqCoverageResult = await _internals23.runRequirementCoverageCheck(validatedDir, phase);
+  const reqCoverageResult = await _internals25.runRequirementCoverageCheck(validatedDir, phase);
   checks5.push(reqCoverageResult);
   log(`[Preflight] Requirement coverage check: ${reqCoverageResult.status} ${reqCoverageResult.message}`);
   if (!cfg.skipVersion) {
     log("[Preflight] Running version check...");
-    const versionResult = await _internals23.runVersionCheck(validatedDir, cfg.checkTimeoutMs);
+    const versionResult = await _internals25.runVersionCheck(validatedDir, cfg.checkTimeoutMs);
     checks5.push(versionResult);
     log(`[Preflight] Version check: ${versionResult.status} ${versionResult.message}`);
   } else {
@@ -49828,10 +49748,10 @@ function formatPreflightMarkdown(report) {
 async function handlePreflightCommand(directory, _args) {
   const plan = await loadPlan(directory);
   const phase = plan?.current_phase ?? 1;
-  const report = await _internals23.runPreflight(directory, phase);
-  return _internals23.formatPreflightMarkdown(report);
+  const report = await _internals25.runPreflight(directory, phase);
+  return _internals25.formatPreflightMarkdown(report);
 }
-var MIN_CHECK_TIMEOUT_MS = 5000, MAX_CHECK_TIMEOUT_MS = 300000, DEFAULT_CONFIG, _internals23;
+var MIN_CHECK_TIMEOUT_MS = 5000, MAX_CHECK_TIMEOUT_MS = 300000, DEFAULT_CONFIG, _internals25;
 var init_preflight_service = __esm(() => {
   init_manager2();
   init_manager();
@@ -49848,7 +49768,7 @@ var init_preflight_service = __esm(() => {
     testScope: "convention",
     linter: "biome"
   };
-  _internals23 = {
+  _internals25 = {
     runPreflight,
     formatPreflightMarkdown,
     handlePreflightCommand,
@@ -51372,6 +51292,25 @@ var init_context_budget_service = __esm(() => {
 });
 
 // src/services/status-service.ts
+import * as fsSync2 from "fs";
+import * as path46 from "path";
+function readSpecStalenessSnapshot(directory) {
+  try {
+    const p = path46.join(directory, ".swarm", "spec-staleness.json");
+    if (!fsSync2.existsSync(p))
+      return { stale: false };
+    const raw = fsSync2.readFileSync(p, "utf-8");
+    const parsed = JSON.parse(raw);
+    return {
+      stale: true,
+      reason: typeof parsed?.reason === "string" ? parsed.reason : undefined,
+      storedHash: typeof parsed?.specHash_plan === "string" ? parsed.specHash_plan : undefined,
+      currentHash: typeof parsed?.specHash_current === "string" || parsed?.specHash_current === null ? parsed.specHash_current : undefined
+    };
+  } catch {
+    return { stale: false };
+  }
+}
 async function getStatusData(directory, agents) {
   const plan = await loadPlan(directory);
   let status;
@@ -51437,11 +51376,21 @@ async function getStatusData(directory, agents) {
       };
     }
   }
+  const drift = readSpecStalenessSnapshot(directory);
+  if (drift.stale) {
+    status.specStale = true;
+    status.specStaleReason = drift.reason;
+    status.specStaleStoredHash = drift.storedHash;
+    status.specStaleCurrentHash = drift.currentHash;
+  } else if (plan && plan._specStale) {
+    status.specStale = true;
+    status.specStaleReason = plan._specStaleReason;
+  }
   return enrichWithLeanTurbo(status, directory);
 }
 function enrichWithLeanTurbo(status, directory) {
   const turboMode = hasActiveTurboMode();
-  const leanActive = _internals24.hasActiveLeanTurbo();
+  const leanActive = _internals26.hasActiveLeanTurbo();
   let turboStrategy = "off";
   if (leanActive) {
     turboStrategy = "lean";
@@ -51460,7 +51409,7 @@ function enrichWithLeanTurbo(status, directory) {
     }
   }
   if (leanSessionID) {
-    const runState = _internals24.loadLeanTurboRunState(directory, leanSessionID);
+    const runState = _internals26.loadLeanTurboRunState(directory, leanSessionID);
     if (runState) {
       status.leanTurboPhase = runState.phase;
       status.leanMaxParallelCoders = runState.maxParallelCoders;
@@ -51492,7 +51441,7 @@ function enrichWithLeanTurbo(status, directory) {
       }
     }
   }
-  status.fullAutoActive = _internals24.hasActiveFullAuto();
+  status.fullAutoActive = _internals26.hasActiveFullAuto();
   return status;
 }
 function formatStatusMarkdown(status) {
@@ -51503,6 +51452,12 @@ function formatStatusMarkdown(status) {
     `**Tasks**: ${status.completedTasks}/${status.totalTasks} complete`,
     `**Agents**: ${status.agentCount} registered`
   ];
+  if (status.specStale) {
+    const reason = status.specStaleReason ?? "spec.md changed since plan saved";
+    const stored = status.specStaleStoredHash ?? "unknown";
+    const current = status.specStaleCurrentHash ?? "(spec.md missing)";
+    lines.push("", `**Spec drift detected**: ${reason} (stored: ${stored}, current: ${current})`, "Run `/swarm clarify` to update the spec or `/swarm acknowledge-spec-drift` to dismiss.");
+  }
   if (status.turboStrategy && status.turboStrategy !== "off") {
     lines.push("");
     if (status.turboStrategy === "lean") {
@@ -51552,11 +51507,23 @@ function formatStatusMarkdown(status) {
 async function handleStatusCommand(directory, agents) {
   const statusData = await getStatusData(directory, agents);
   if (!statusData.hasPlan) {
+    if (statusData.specStale) {
+      const reason = statusData.specStaleReason ?? "spec.md changed since plan saved";
+      const stored = statusData.specStaleStoredHash ?? "unknown";
+      const current = statusData.specStaleCurrentHash ?? "(spec.md missing)";
+      return [
+        "No active swarm plan found.",
+        "",
+        `**Spec drift detected**: ${reason} (stored: ${stored}, current: ${current})`,
+        "Run `/swarm clarify` to update the spec or `/swarm acknowledge-spec-drift` to dismiss."
+      ].join(`
+`);
+    }
     return "No active swarm plan found.";
   }
   return formatStatusMarkdown(statusData);
 }
-var _internals24;
+var _internals26;
 var init_status_service = __esm(() => {
   init_extractors();
   init_utils2();
@@ -51565,7 +51532,7 @@ var init_status_service = __esm(() => {
   init_state3();
   init_compaction_service();
   init_context_budget_service();
-  _internals24 = {
+  _internals26 = {
     loadLeanTurboRunState,
     hasActiveLeanTurbo,
     hasActiveFullAuto
@@ -51656,7 +51623,7 @@ async function handleTurboCommand(directory, args, sessionID) {
   if (arg0 === "on") {
     let strategy = "standard";
     try {
-      const { config: config3 } = _internals25.loadPluginConfigWithMeta(directory);
+      const { config: config3 } = _internals27.loadPluginConfigWithMeta(directory);
       if (config3.turbo?.strategy === "lean") {
         strategy = "lean";
       }
@@ -51711,7 +51678,7 @@ function enableLeanTurbo(session, directory, sessionID) {
   let maxParallelCoders = 4;
   let conflictPolicy = "serialize";
   try {
-    const { config: config3 } = _internals25.loadPluginConfigWithMeta(directory);
+    const { config: config3 } = _internals27.loadPluginConfigWithMeta(directory);
     const leanConfig = config3.turbo?.lean;
     if (leanConfig) {
       maxParallelCoders = leanConfig.max_parallel_coders ?? 4;
@@ -51781,13 +51748,13 @@ function buildStatusMessage(session, directory, sessionID) {
   ].join(`
 `);
 }
-var _internals25;
+var _internals27;
 var init_turbo = __esm(() => {
   init_config();
   init_state();
   init_state3();
   init_logger();
-  _internals25 = {
+  _internals27 = {
     loadPluginConfigWithMeta
   };
 });
@@ -51853,6 +51820,270 @@ var init_write_retro2 = __esm(() => {
   init_write_retro();
 });
 
+// src/commands/command-dispatch.ts
+import fs28 from "fs";
+import path47 from "path";
+function normalizeSwarmCommandInput(command, argumentText) {
+  if (command !== "swarm" && !command.startsWith("swarm-")) {
+    return { isSwarmCommand: false, tokens: [] };
+  }
+  if (command === "swarm") {
+    return {
+      isSwarmCommand: true,
+      tokens: argumentText.trim().split(/\s+/).filter(Boolean)
+    };
+  }
+  const subcommand = command.slice("swarm-".length);
+  const extraArgs = argumentText.trim().split(/\s+/).filter(Boolean);
+  return {
+    isSwarmCommand: true,
+    tokens: [subcommand, ...extraArgs].filter(Boolean)
+  };
+}
+function canonicalCommandKey(resolved) {
+  return resolved.entry.aliasOf ?? resolved.key;
+}
+function formatCommandNotFound(tokens) {
+  const attemptedCommand = tokens[0] || "";
+  const MAX_DISPLAY = 100;
+  const displayCommand = attemptedCommand.length > MAX_DISPLAY ? `${attemptedCommand.slice(0, MAX_DISPLAY)}...` : attemptedCommand;
+  const similar = _internals28.findSimilarCommands(attemptedCommand);
+  const header = `Command \`/swarm ${displayCommand}\` not found.`;
+  const suggestions = similar.length > 0 ? `Did you mean:
+${similar.map((cmd) => `  - /swarm ${cmd}`).join(`
+`)}` : "";
+  const footer = "Run `/swarm help` for all commands.";
+  return [header, suggestions, footer].filter(Boolean).join(`
+
+`);
+}
+function maybeMarkFirstRun(directory) {
+  const sentinelPath = path47.join(directory, ".swarm", ".first-run-complete");
+  try {
+    const swarmDir = path47.join(directory, ".swarm");
+    fs28.mkdirSync(swarmDir, { recursive: true });
+    fs28.writeFileSync(sentinelPath, `first-run-complete: ${new Date().toISOString()}
+`, { flag: "wx" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function prependWelcome(text) {
+  const welcomeMessage = `Welcome to OpenCode Swarm!
+` + `
+` + `Run \`/swarm help\` to see all available commands, or \`/swarm config\` to review your configuration.
+`;
+  return welcomeMessage + text;
+}
+async function executeSwarmCommand(args) {
+  const {
+    directory,
+    agents,
+    sessionID,
+    tokens,
+    includeWelcome = false,
+    buildHelpText,
+    policy
+  } = args;
+  let text;
+  const resolved = resolveCommand(tokens);
+  if (!resolved) {
+    text = tokens.length === 0 && buildHelpText ? buildHelpText() : formatCommandNotFound(tokens);
+  } else {
+    const policyResult = policy?.(resolved) ?? { allowed: true };
+    if (!policyResult.allowed) {
+      text = policyResult.message;
+    } else {
+      try {
+        text = await resolved.entry.handler({
+          directory,
+          args: resolved.remainingArgs,
+          sessionID,
+          agents
+        });
+      } catch (_err) {
+        const cmdName = tokens[0] || "unknown";
+        const errMsg = _err instanceof Error ? _err.message : String(_err);
+        text = `Error executing /swarm ${cmdName}: ${errMsg}`;
+      }
+      if (resolved.warning) {
+        text = `${resolved.warning}
+
+${text}`;
+      }
+    }
+  }
+  if (includeWelcome && maybeMarkFirstRun(directory)) {
+    text = prependWelcome(text);
+  }
+  return {
+    text,
+    resolved: resolved ?? undefined,
+    canonicalKey: resolved ? canonicalCommandKey(resolved) : undefined
+  };
+}
+var init_command_dispatch = __esm(() => {
+  init_registry();
+});
+
+// src/commands/tool-policy.ts
+function classifySwarmCommandToolUse(resolved) {
+  const canonicalKey = canonicalCommandKey(resolved);
+  const args = resolved.remainingArgs;
+  if (!SWARM_COMMAND_TOOL_ALLOWLIST.has(canonicalKey)) {
+    return {
+      allowed: false,
+      message: `/swarm ${canonicalKey} is not available through the chat tool yet.
+
+` + `Use the canonical CLI path for now: \`bunx opencode-swarm run ${canonicalKey}\`.
+` + `Commands with state changes, auto-heal behavior, or subprocesses need confirmation gates before chat-tool support.`
+    };
+  }
+  if (canonicalKey === "config doctor" && args.some((arg) => arg === "--fix" || arg === "-f")) {
+    return {
+      allowed: false,
+      message: "/swarm config doctor --fix is not available through swarm_command. Run the CLI command directly when you intend to modify config files."
+    };
+  }
+  if (NO_ARGS.has(canonicalKey) && args.length > 0) {
+    return {
+      allowed: false,
+      message: `/swarm ${canonicalKey} does not accept arguments through swarm_command.`
+    };
+  }
+  if (canonicalKey === "knowledge") {
+    if (args.length === 0)
+      return { allowed: true };
+    if (args.length === 1 && args[0] === "list")
+      return { allowed: true };
+    return {
+      allowed: false,
+      message: "Only `/swarm knowledge` and `/swarm knowledge list` are available through swarm_command. Knowledge migrate/quarantine/restore are intentionally excluded."
+    };
+  }
+  if (canonicalKey === "retrieve") {
+    if (args.length !== 1 || !SUMMARY_ID_PATTERN.test(args[0])) {
+      return {
+        allowed: false,
+        message: "Usage through swarm_command: `/swarm retrieve <summary-id>` with a single summary ID such as S1."
+      };
+    }
+  }
+  if (canonicalKey === "benchmark") {
+    const allowedFlags = new Set(["--cumulative", "--ci-gate"]);
+    const invalid = args.filter((arg) => !allowedFlags.has(arg));
+    if (invalid.length > 0) {
+      return {
+        allowed: false,
+        message: "Only `--cumulative` and `--ci-gate` are supported for `/swarm benchmark` through swarm_command."
+      };
+    }
+  }
+  if (canonicalKey === "show-plan") {
+    if (args.length > 1 || args[0] && !/^\d+$/.test(args[0])) {
+      return {
+        allowed: false,
+        message: "Usage through swarm_command: `/swarm show-plan` or `/swarm show-plan <phase-number>`."
+      };
+    }
+  }
+  if (canonicalKey === "evidence") {
+    if (args.length > 1 || args[0] && !TASK_ID_PATTERN.test(args[0])) {
+      return {
+        allowed: false,
+        message: "Usage through swarm_command: `/swarm evidence` or `/swarm evidence <task-id>`."
+      };
+    }
+  }
+  if (canonicalKey === "help" && args.length > 2) {
+    return {
+      allowed: false,
+      message: "Usage through swarm_command: `/swarm help` or `/swarm help <command>`."
+    };
+  }
+  return { allowed: true };
+}
+function classifySwarmCommandChatFallbackUse(resolved) {
+  const canonicalKey = canonicalCommandKey(resolved);
+  const args = resolved.remainingArgs;
+  if (canonicalKey === "config doctor" && args.some((arg) => arg === "--fix" || arg === "-f")) {
+    return {
+      allowed: false,
+      message: "/swarm config doctor --fix is not available through chat fallback because it can modify configuration files. Run the CLI command directly when you intend to apply fixes."
+    };
+  }
+  if (canonicalKey === "knowledge migrate" || canonicalKey === "knowledge quarantine" || canonicalKey === "knowledge restore") {
+    return {
+      allowed: false,
+      message: `/swarm ${canonicalKey} is not available through chat fallback because it mutates .swarm knowledge state. ` + "Run the CLI command directly after confirming the intended state change."
+    };
+  }
+  return { allowed: true };
+}
+var SWARM_COMMAND_TOOL_COMMANDS, SWARM_COMMAND_TOOL_ALLOWLIST, NO_ARGS, SUMMARY_ID_PATTERN, TASK_ID_PATTERN;
+var init_tool_policy = __esm(() => {
+  init_command_dispatch();
+  SWARM_COMMAND_TOOL_COMMANDS = [
+    "agents",
+    "config",
+    "config doctor",
+    "config-doctor",
+    "doctor",
+    "doctor tools",
+    "status",
+    "show-plan",
+    "plan",
+    "help",
+    "history",
+    "evidence",
+    "evidence summary",
+    "evidence-summary",
+    "retrieve",
+    "diagnose",
+    "preflight",
+    "benchmark",
+    "knowledge",
+    "sync-plan",
+    "export",
+    "list-agents"
+  ];
+  SWARM_COMMAND_TOOL_ALLOWLIST = new Set([
+    "agents",
+    "config",
+    "config doctor",
+    "doctor tools",
+    "status",
+    "show-plan",
+    "help",
+    "history",
+    "evidence",
+    "evidence summary",
+    "retrieve",
+    "diagnose",
+    "preflight",
+    "benchmark",
+    "knowledge",
+    "sync-plan",
+    "export"
+  ]);
+  NO_ARGS = new Set([
+    "agents",
+    "config",
+    "config doctor",
+    "doctor tools",
+    "status",
+    "history",
+    "evidence summary",
+    "diagnose",
+    "preflight",
+    "sync-plan",
+    "export"
+  ]);
+  SUMMARY_ID_PATTERN = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
+  TASK_ID_PATTERN = /^[A-Za-z0-9_.:-]{1,64}$/;
+});
+
 // src/commands/command-names.ts
 var COMMAND_NAMES, COMMAND_NAME_SET;
 var init_command_names = __esm(() => {
@@ -51865,6 +52096,7 @@ var init_command_names = __esm(() => {
 var exports_commands = {};
 __export(exports_commands, {
   resolveCommand: () => resolveCommand,
+  normalizeSwarmCommandInput: () => normalizeSwarmCommandInput,
   handleWriteRetroCommand: () => handleWriteRetroCommand,
   handleTurboCommand: () => handleTurboCommand,
   handleSyncPlanCommand: () => handleSyncPlanCommand,
@@ -51906,18 +52138,27 @@ __export(exports_commands, {
   handleAnalyzeCommand: () => handleAnalyzeCommand,
   handleAgentsCommand: () => handleAgentsCommand,
   handleAcknowledgeSpecDriftCommand: () => handleAcknowledgeSpecDriftCommand,
+  formatCommandNotFound: () => formatCommandNotFound,
+  executeSwarmCommand: () => executeSwarmCommand,
   createSwarmCommandHandler: () => createSwarmCommandHandler,
+  classifySwarmCommandToolUse: () => classifySwarmCommandToolUse,
+  classifySwarmCommandChatFallbackUse: () => classifySwarmCommandChatFallbackUse,
   buildHelpText: () => buildHelpText,
+  agentHasSwarmCommandTool: () => agentHasSwarmCommandTool,
   VALID_COMMANDS: () => VALID_COMMANDS,
-  LLM_MEDIATION_WARNING: () => LLM_MEDIATION_WARNING,
+  SWARM_COMMAND_TOOL_COMMANDS: () => SWARM_COMMAND_TOOL_COMMANDS,
+  SWARM_COMMAND_TOOL_ALLOWLIST: () => SWARM_COMMAND_TOOL_ALLOWLIST,
   COMMAND_REGISTRY: () => COMMAND_REGISTRY,
   COMMAND_NAME_SET: () => COMMAND_NAME_SET,
   COMMAND_NAMES: () => COMMAND_NAMES
 });
-import fs28 from "fs";
-import path46 from "path";
 function buildHelpText() {
-  const lines = ["## Swarm Commands", "", LLM_MEDIATION_WARNING, ""];
+  const lines = [
+    "## Swarm Commands",
+    "",
+    "**Chat routing note**: supported read-only `/swarm` commands are routed through the `swarm_command` tool when the active agent has that tool. Unsupported or state-changing commands remain chat-mediated; use `bunx opencode-swarm run <subcommand>` when you need canonical output.",
+    ""
+  ];
   const CATEGORIES = [
     "core",
     "agent",
@@ -52012,92 +52253,127 @@ function buildHelpText() {
   return lines.join(`
 `);
 }
-function createSwarmCommandHandler(directory, agents, client) {
+function createSwarmCommandHandler(directory, agents, options = {}) {
   return async (input, output) => {
-    if (input.command !== "swarm" && !input.command.startsWith("swarm-")) {
+    const normalized = normalizeSwarmCommandInput(input.command, input.arguments);
+    if (!normalized.isSwarmCommand) {
       return;
     }
-    let isFirstRun = false;
-    const sentinelPath = path46.join(directory, ".swarm", ".first-run-complete");
-    try {
-      const swarmDir = path46.join(directory, ".swarm");
-      fs28.mkdirSync(swarmDir, { recursive: true });
-      fs28.writeFileSync(sentinelPath, `first-run-complete: ${new Date().toISOString()}
-`, { flag: "wx" });
-      isFirstRun = true;
-    } catch (_err) {}
-    let tokens;
-    if (input.command === "swarm") {
-      tokens = input.arguments.trim().split(/\s+/).filter(Boolean);
-    } else {
-      const subcommand = input.command.slice("swarm-".length);
-      const extraArgs = input.arguments.trim().split(/\s+/).filter(Boolean);
-      tokens = [subcommand, ...extraArgs];
-    }
-    let text;
-    const resolved = resolveCommand(tokens);
-    if (!resolved) {
-      if (tokens.length === 0) {
-        text = buildHelpText();
-      } else {
-        const attemptedCommand = tokens[0] || "";
-        const MAX_DISPLAY = 100;
-        const displayCommand = attemptedCommand.length > MAX_DISPLAY ? `${attemptedCommand.slice(0, MAX_DISPLAY)}...` : 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(`
-`)}` : "";
-        const footer = "Run `/swarm help` for all commands.";
-        text = [header, suggestions, footer].filter(Boolean).join(`
-
-`);
-      }
-    } else {
-      try {
-        text = await resolved.entry.handler({
-          directory,
-          args: resolved.remainingArgs,
-          sessionID: input.sessionID,
-          agents,
-          client
-        });
-      } catch (_err) {
-        const cmdName = tokens[0] || "unknown";
-        const errMsg = _err instanceof Error ? _err.message : String(_err);
-        text = `Error executing /swarm ${cmdName}: ${errMsg}`;
-      }
-      if (resolved.warning) {
-        text = `${resolved.warning}
-
-${text}`;
-      }
-    }
-    if (isFirstRun) {
-      const welcomeMessage = `Welcome to OpenCode Swarm! \uD83D\uDC1D
-` + `
-` + `Start here: run \`/swarm diagnose\`, then \`/swarm agents\` to confirm the plugin loaded and see the exact models in use.
-` + `If a model is unavailable, edit \`.opencode/opencode-swarm.json\` or \`~/.config/opencode/opencode-swarm.json\` and run \`/swarm config doctor\`.
-` + `Useful next steps: \`/swarm brainstorm <task>\` for guided planning, \`/swarm full-auto on\` for autonomous runs after enabling it in config, and \`/swarm council <question>\` after enabling council.general.
-
-`;
-      text = welcomeMessage + text;
-    }
     output.parts.splice(0, output.parts.length, {
       type: "text",
-      text
+      text: await buildSwarmCommandPrompt({
+        directory,
+        agents,
+        sessionID: input.sessionID,
+        tokens: normalized.tokens,
+        activeAgentName: options.getActiveAgentName?.(input.sessionID),
+        registeredAgents: options.registeredAgents
+      })
     });
+    return;
   };
 }
-var LLM_MEDIATION_WARNING;
+async function buildSwarmCommandPrompt(args) {
+  const {
+    directory,
+    agents,
+    sessionID,
+    tokens,
+    activeAgentName,
+    registeredAgents
+  } = args;
+  const resolved = _internals28.resolveCommand(tokens);
+  if (!resolved) {
+    if (tokens.length === 0) {
+      return buildHelpText();
+    }
+    return formatCommandNotFound(tokens);
+  }
+  const typedResolved = resolved;
+  const canonicalKey = canonicalCommandKey(typedResolved);
+  const policy = classifySwarmCommandToolUse(typedResolved);
+  const isV1ToolCommand = SWARM_COMMAND_TOOL_ALLOWLIST.has(canonicalKey);
+  const canUseTool = agentHasSwarmCommandTool(activeAgentName, agents, registeredAgents);
+  if (canUseTool && policy.allowed && isV1ToolCommand) {
+    return routeToSwarmCommandTool({
+      command: canonicalKey,
+      args: resolved.remainingArgs,
+      original: `/swarm ${tokens.join(" ")}`.trim()
+    });
+  }
+  if (canUseTool && isV1ToolCommand && !policy.allowed) {
+    return [
+      `The user typed \`/swarm ${tokens.join(" ")}\`.`,
+      policy.message,
+      "Do not invent command output. Explain the limitation and recommend the canonical CLI path above."
+    ].join(`
+`);
+  }
+  const chatFallbackPolicy = classifySwarmCommandChatFallbackUse(typedResolved);
+  if (!chatFallbackPolicy.allowed) {
+    return [
+      `The user typed \`/swarm ${tokens.join(" ")}\`.`,
+      chatFallbackPolicy.message,
+      "Do not execute this command through chat and do not invent command output."
+    ].join(`
+`);
+  }
+  const result = await executeSwarmCommand({
+    directory,
+    agents,
+    sessionID,
+    tokens
+  });
+  return formatCanonicalPromptFallback({
+    original: `/swarm ${tokens.join(" ")}`.trim(),
+    text: result.text
+  });
+}
+function agentHasSwarmCommandTool(activeAgentName, agents, registeredAgents) {
+  const name = activeAgentName ?? ORCHESTRATOR_NAME;
+  const registeredTools = registeredAgents?.[name]?.tools;
+  if (registeredTools) {
+    return registeredTools.swarm_command === true;
+  }
+  const explicitTools = agents[name]?.config?.tools;
+  if (explicitTools) {
+    return explicitTools.swarm_command === true;
+  }
+  const baseName = stripKnownSwarmPrefix(name);
+  return AGENT_TOOL_MAP[baseName]?.includes("swarm_command") === true;
+}
+function formatCanonicalPromptFallback(args) {
+  return [
+    `The user typed \`${args.original}\`.`,
+    "Canonical opencode-swarm command output follows.",
+    "Show this output verbatim and add no extra swarm state.",
+    "",
+    args.text
+  ].join(`
+`);
+}
+function routeToSwarmCommandTool(args) {
+  return [
+    `The user typed \`${args.original}\`.`,
+    "Call the `swarm_command` tool exactly once with:",
+    JSON.stringify({ command: args.command, args: args.args }, null, 2),
+    "After the tool returns, show the tool output verbatim and add no extra swarm state."
+  ].join(`
+`);
+}
 var init_commands = __esm(() => {
+  init_constants();
+  init_schema();
+  init_command_dispatch();
   init_registry();
+  init_tool_policy();
   init_acknowledge_spec_drift();
   init_agents();
   init_archive();
   init_benchmark();
   init_checkpoint2();
   init_close();
+  init_command_dispatch();
   init_command_names();
   init_config2();
   init_council();
@@ -52125,10 +52401,9 @@ var init_commands = __esm(() => {
   init_simulate();
   init_status();
   init_sync_plan();
+  init_tool_policy();
   init_turbo();
   init_write_retro2();
-  LLM_MEDIATION_WARNING = "> \u26A0\uFE0F Chat-typed `/swarm` is LLM-mediated in current OpenCode (see anomalyco/opencode#9306).\n" + `> The text below is the canonical handler output, but the model may rephrase it before display.
-` + "> For deterministic output, run `bunx opencode-swarm run <subcommand>` from a terminal.";
 });
 
 // src/commands/registry.ts
@@ -52158,7 +52433,7 @@ function findSimilarCommands(query) {
   }
   const scored = VALID_COMMANDS.map((cmd) => {
     const cmdLower = cmd.toLowerCase();
-    const fullScore = _internals26.levenshteinDistance(q, cmdLower);
+    const fullScore = _internals28.levenshteinDistance(q, cmdLower);
     let tokenScore = Infinity;
     if (cmd.includes(" ") || cmd.includes("-")) {
       const qTokens = q.split(/[\s-]+/);
@@ -52171,7 +52446,7 @@ function findSimilarCommands(query) {
         for (const ct of cmdTokens) {
           if (ct.length === 0)
             continue;
-          const dist = _internals26.levenshteinDistance(qt, ct);
+          const dist = _internals28.levenshteinDistance(qt, ct);
           if (dist < minDist)
             minDist = dist;
         }
@@ -52181,7 +52456,7 @@ function findSimilarCommands(query) {
     }
     const dashStrippedQ = q.replace(/-/g, "");
     const dashStrippedCmd = cmdLower.replace(/-/g, "");
-    const dashScore = _internals26.levenshteinDistance(dashStrippedQ, dashStrippedCmd);
+    const dashScore = _internals28.levenshteinDistance(dashStrippedQ, dashStrippedCmd);
     const score = Math.min(fullScore, tokenScore, dashScore);
     return { cmd, score };
   });
@@ -52213,11 +52488,11 @@ async function handleHelpCommand(ctx) {
     return buildHelpText2();
   }
   const tokens = targetCommand.split(/\s+/);
-  const resolved = _internals26.resolveCommand(tokens);
+  const resolved = _internals28.resolveCommand(tokens);
   if (resolved) {
-    return _internals26.buildDetailedHelp(resolved.key, resolved.entry);
+    return _internals28.buildDetailedHelp(resolved.key, resolved.entry);
   }
-  const similar = _internals26.findSimilarCommands(targetCommand);
+  const similar = _internals28.findSimilarCommands(targetCommand);
   const { buildHelpText: fullHelp } = await Promise.resolve().then(() => (init_commands(), exports_commands));
   if (similar.length > 0) {
     return `Command '/swarm ${targetCommand}' not found.
@@ -52253,24 +52528,24 @@ function validateAliases() {
       }
       aliasTargets.get(target).push(name);
       const visited = new Set;
-      const path47 = [];
+      const path48 = [];
       let current = target;
       while (current) {
         const currentEntry = COMMAND_REGISTRY[current];
         if (!currentEntry)
           break;
         if (visited.has(current)) {
-          const cycleStart = path47.indexOf(current);
+          const cycleStart = path48.indexOf(current);
           const fullChain = [
             name,
-            ...path47.slice(0, cycleStart > 0 ? cycleStart : path47.length),
+            ...path48.slice(0, cycleStart > 0 ? cycleStart : path48.length),
             current
           ].join(" \u2192 ");
           errors5.push(`Circular alias detected: ${fullChain}`);
           break;
         }
         visited.add(current);
-        path47.push(current);
+        path48.push(current);
         current = currentEntry.aliasOf || "";
       }
     }
@@ -52311,7 +52586,7 @@ function resolveCommand(tokens) {
   }
   return null;
 }
-var COMMAND_REGISTRY, VALID_COMMANDS, _internals26, validation;
+var COMMAND_REGISTRY, VALID_COMMANDS, _internals28, validation;
 var init_registry = __esm(() => {
   init_acknowledge_spec_drift();
   init_agents();
@@ -52381,7 +52656,7 @@ var init_registry = __esm(() => {
       clashesWithNativeCcCommand: "/agents"
     },
     help: {
-      handler: (ctx) => _internals26.handleHelpCommand(ctx),
+      handler: (ctx) => _internals28.handleHelpCommand(ctx),
       description: "Show help for swarm commands",
       category: "core",
       args: "[command]",
@@ -52400,13 +52675,13 @@ var init_registry = __esm(() => {
       clashesWithNativeCcCommand: "/config"
     },
     "config doctor": {
-      handler: (ctx) => handleDoctorCommand(ctx.directory, ctx.args, { client: ctx.client }),
+      handler: (ctx) => handleDoctorCommand(ctx.directory, ctx.args),
       description: "Run config doctor checks",
       subcommandOf: "config",
       category: "diagnostics"
     },
     "config-doctor": {
-      handler: (ctx) => handleDoctorCommand(ctx.directory, ctx.args, { client: ctx.client }),
+      handler: (ctx) => handleDoctorCommand(ctx.directory, ctx.args),
       description: "Run config doctor checks",
       subcommandOf: "config",
       category: "diagnostics",
@@ -52481,7 +52756,7 @@ var init_registry = __esm(() => {
       deprecated: true
     },
     doctor: {
-      handler: (ctx) => handleDoctorCommand(ctx.directory, ctx.args, { client: ctx.client }),
+      handler: (ctx) => handleDoctorCommand(ctx.directory, ctx.args),
       description: "Run config doctor checks",
       category: "diagnostics",
       aliasOf: "config doctor",
@@ -52753,7 +53028,7 @@ Subcommands:
     }
   };
   VALID_COMMANDS = Object.keys(COMMAND_REGISTRY);
-  _internals26 = {
+  _internals28 = {
     handleHelpCommand,
     validateAliases,
     resolveCommand,
@@ -52761,7 +53036,7 @@ Subcommands:
     findSimilarCommands,
     buildDetailedHelp
   };
-  validation = _internals26.validateAliases();
+  validation = _internals28.validateAliases();
   if (!validation.valid) {
     throw new Error(`COMMAND_REGISTRY alias validation failed:
 ${validation.errors.join(`
@@ -52781,53 +53056,53 @@ init_cache_paths();
 init_constants();
 import * as fs29 from "fs";
 import * as os7 from "os";
-import * as path47 from "path";
+import * as path48 from "path";
 var { version: version4 } = package_default;
 var CONFIG_DIR = getPluginConfigDir();
-var OPENCODE_CONFIG_PATH = path47.join(CONFIG_DIR, "opencode.json");
-var PLUGIN_CONFIG_PATH = path47.join(CONFIG_DIR, "opencode-swarm.json");
-var PROMPTS_DIR = path47.join(CONFIG_DIR, "opencode-swarm");
+var OPENCODE_CONFIG_PATH = path48.join(CONFIG_DIR, "opencode.json");
+var PLUGIN_CONFIG_PATH = path48.join(CONFIG_DIR, "opencode-swarm.json");
+var PROMPTS_DIR = path48.join(CONFIG_DIR, "opencode-swarm");
 var OPENCODE_PLUGIN_CACHE_PATHS = getPluginCachePaths();
 var OPENCODE_PLUGIN_LOCK_FILE_PATHS = getPluginLockFilePaths();
 function isSafeCachePath(p) {
-  const resolved = path47.resolve(p);
-  const home = path47.resolve(os7.homedir());
+  const resolved = path48.resolve(p);
+  const home = path48.resolve(os7.homedir());
   if (resolved === "/" || resolved === home || resolved.length <= home.length) {
     return false;
   }
-  const segments = resolved.split(path47.sep).filter((s) => s.length > 0);
+  const segments = resolved.split(path48.sep).filter((s) => s.length > 0);
   if (segments.length < 4) {
     return false;
   }
-  const leaf = path47.basename(resolved);
+  const leaf = path48.basename(resolved);
   if (leaf !== "opencode-swarm@latest" && leaf !== "opencode-swarm") {
     return false;
   }
-  const parent = path47.basename(path47.dirname(resolved));
+  const parent = path48.basename(path48.dirname(resolved));
   if (parent !== "packages" && parent !== "node_modules") {
     return false;
   }
-  const grandparent = path47.basename(path47.dirname(path47.dirname(resolved)));
+  const grandparent = path48.basename(path48.dirname(path48.dirname(resolved)));
   if (grandparent !== "opencode") {
     return false;
   }
   return true;
 }
 function isSafeLockFilePath(p) {
-  const resolved = path47.resolve(p);
-  const home = path47.resolve(os7.homedir());
+  const resolved = path48.resolve(p);
+  const home = path48.resolve(os7.homedir());
   if (resolved === "/" || resolved === home || resolved.length <= home.length) {
     return false;
   }
-  const segments = resolved.split(path47.sep).filter((s) => s.length > 0);
+  const segments = resolved.split(path48.sep).filter((s) => s.length > 0);
   if (segments.length < 4) {
     return false;
   }
-  const leaf = path47.basename(resolved);
+  const leaf = path48.basename(resolved);
   if (leaf !== "bun.lock" && leaf !== "bun.lockb" && leaf !== "package-lock.json") {
     return false;
   }
-  const parent = path47.basename(path47.dirname(resolved));
+  const parent = path48.basename(path48.dirname(resolved));
   if (parent !== "opencode") {
     return false;
   }
@@ -52853,8 +53128,8 @@ function saveJson(filepath, data) {
 }
 function writeProjectConfigIfMissing(cwd) {
   try {
-    const opencodeDir = path47.join(cwd, ".opencode");
-    const projectConfigPath = path47.join(opencodeDir, "opencode-swarm.json");
+    const opencodeDir = path48.join(cwd, ".opencode");
+    const projectConfigPath = path48.join(opencodeDir, "opencode-swarm.json");
     if (fs29.existsSync(projectConfigPath)) {
       return;
     }
@@ -52871,7 +53146,7 @@ async function install() {
 `);
   ensureDir(CONFIG_DIR);
   ensureDir(PROMPTS_DIR);
-  const LEGACY_CONFIG_PATH = path47.join(CONFIG_DIR, "config.json");
+  const LEGACY_CONFIG_PATH = path48.join(CONFIG_DIR, "config.json");
   let opencodeConfig = loadJson(OPENCODE_CONFIG_PATH);
   if (!opencodeConfig) {
     const legacyConfig = loadJson(LEGACY_CONFIG_PATH);