opencode-swarm-plugin 0.56.1 → 0.57.0

package/dist/index.js

@@ -26934,6 +26934,7 @@ __export(exports_skills, {
   invalidateSkillsCache: () => invalidateSkillsCache,
   getSkillsContextForSwarm: () => getSkillsContextForSwarm,
   getSkill: () => getSkill,
+  getAlwaysOnGuidanceSkill: () => getAlwaysOnGuidanceSkill,
   findRelevantSkills: () => findRelevantSkills,
   discoverSkills: () => discoverSkills
 });
@@ -26949,6 +26950,44 @@ import {
 } from "path";
 import { fileURLToPath } from "url";
 import { getSwarmMailLibSQL as getSwarmMailLibSQL3, createEvent as createEvent2 } from "swarm-mail";
+function resolveGuidanceModel(model) {
+  if (!model)
+    return "unknown";
+  const normalized = model.toLowerCase();
+  if (normalized.includes("gpt-5.2")) {
+    return "gpt-5.2-code";
+  }
+  if (normalized.includes("opus-4-5") || normalized.includes("opus 4.5")) {
+    return "opus-4.5";
+  }
+  return "unknown";
+}
+function getAlwaysOnGuidanceSkill(options2) {
+  const roleGuidance = ALWAYS_ON_ROLE_GUIDANCE[options2.role];
+  const modelBucket = resolveGuidanceModel(options2.model);
+  let modelGuidance = "";
+  if (modelBucket === "gpt-5.2-code") {
+    modelGuidance = `### Model-Specific Guidance
+${GPT_5_2_GUIDANCE}`;
+  } else if (modelBucket === "opus-4.5") {
+    modelGuidance = `### Model-Specific Guidance
+${OPUS_4_5_GUIDANCE}`;
+  } else {
+    modelGuidance = `### Model-Specific Guidance
+${GPT_5_2_GUIDANCE}
+
+${OPUS_4_5_GUIDANCE}`;
+  }
+  return [
+    ALWAYS_ON_GUIDANCE_HEADER,
+    ALWAYS_ON_TOOL_PRIORITY,
+    ALWAYS_ON_RULE_FOLLOWING,
+    roleGuidance,
+    modelGuidance
+  ].join(`
+
+`);
+}
 async function emitSkillLoadedEvent(data) {
   try {
     const projectPath = skillsProjectDirectory;
@@ -27348,10 +27387,38 @@ async function findRelevantSkills(taskDescription) {
   }
   return relevant;
 }
-var import_gray_matter, skillsProjectDirectory, skillsCache = null, PROJECT_SKILL_DIRECTORIES, skills_list, skills_use, skills_execute, skills_read, DEFAULT_SKILLS_DIR = ".opencode/skill", skills_create, skills_update, skills_delete, skills_add_script, skills_init, skillsTools;
+var import_gray_matter, ALWAYS_ON_GUIDANCE_HEADER = "## Always-On Guidance Skill", ALWAYS_ON_TOOL_PRIORITY = `### Tool Priority Order
+1. Swarm plugin tools (\`hive_*\`, \`swarm_*\`, \`swarmmail_*\`, \`structured_*\`)
+2. \`Read\`/\`Edit\` for file operations
+3. \`ast-grep\` for structural search
+4. \`Glob\`/\`Grep\` for discovery
+5. \`Task\` subagents for exploration
+6. \`Bash\` only for system commands
+
+**Never use Bash for file read/write/edit/search.**`, ALWAYS_ON_RULE_FOLLOWING = `### Rule-Following Guardrails
+- Follow explicit tool constraints and approval modes
+- Do not invent tool output or files; ask when unsure
+- Keep changes scoped to assigned files and requirements`, ALWAYS_ON_ROLE_GUIDANCE, GPT_5_2_GUIDANCE = `#### GPT-5.2-code (Strict)
+- Follow instructions literally and exactly
+- Enforce tool priority order; fail closed if a tool is missing
+- Read before Edit; no speculative changes or output`, OPUS_4_5_GUIDANCE = `#### Opus 4.5 (Concise)
+- Be concise and deliberate while obeying mandates
+- Follow tool priorities without shortcuts
+- Prefer direct answers over speculation`, skillsProjectDirectory, skillsCache = null, PROJECT_SKILL_DIRECTORIES, skills_list, skills_use, skills_execute, skills_read, DEFAULT_SKILLS_DIR = ".opencode/skill", skills_create, skills_update, skills_delete, skills_add_script, skills_init, skillsTools;
 var init_skills = __esm(() => {
   init_dist();
   import_gray_matter = __toESM(require_gray_matter(), 1);
+  ALWAYS_ON_ROLE_GUIDANCE = {
+    coordinator: `### Coordinator Enforcement
+- Coordinator role: orchestrate, decompose, spawn workers
+- **Never** edit files or reserve locks directly
+- Coordinator override: use \`swarmmail_release_all\` only for stale/orphaned reservations (announce in Swarm Mail)
+- Review work with \`swarm_review\` before accepting`,
+    worker: `### Worker Enforcement
+- Worker role: implement changes within reserved files
+- Reserve files before edits and follow TDD (RED → GREEN → REFACTOR)
+- Complete with \`swarm_complete\`, not \`hive_close\``
+  };
   skillsProjectDirectory = process.cwd();
   PROJECT_SKILL_DIRECTORIES = [
     ".opencode/skill",
@@ -60505,8 +60572,8 @@ import {
 import { join as join4 } from "path";
 import { tmpdir } from "os";
 var AGENT_MAIL_URL = "http://127.0.0.1:8765";
-var DEFAULT_TTL_SECONDS = 3600;
 var MAX_INBOX_LIMIT = 5;
+var DEFAULT_OPENCODE_MODEL = "openai/gpt-5.2-codex";
 var agentMailProjectDirectory = null;
 function setAgentMailProjectDirectory(directory) {
   agentMailProjectDirectory = directory;
@@ -60916,7 +60983,7 @@ async function reRegisterAgent(projectKey, agentName, taskDescription) {
     await mcpCall("register_agent", {
       project_key: projectKey,
       program: "opencode",
-      model: "claude-opus-4",
+      model: DEFAULT_OPENCODE_MODEL,
       name: agentName,
       task_description: taskDescription || "Re-registered after server restart"
     });
@@ -61005,7 +61072,7 @@ var agentmail_init = tool({
         const agent = await mcpCall("register_agent", {
           project_key: projectPath,
           program: "opencode",
-          model: "claude-opus-4",
+          model: DEFAULT_OPENCODE_MODEL,
           name: args.agent_name,
           task_description: args.task_description || ""
         });
@@ -61148,18 +61215,21 @@ var agentmail_reserve = tool({
   description: "Reserve file paths for exclusive editing",
   args: {
     paths: tool.schema.array(tool.schema.string()).describe("File paths or globs to reserve (e.g., src/auth/**)"),
-    ttl_seconds: tool.schema.number().optional().describe(`Time to live in seconds (default: ${DEFAULT_TTL_SECONDS})`),
+    ttl_seconds: tool.schema.number().int().positive().describe("Time to live in seconds (required)"),
     exclusive: tool.schema.boolean().optional().describe("Exclusive lock (default: true)"),
     reason: tool.schema.string().optional().describe("Reason for reservation (include bead ID)")
   },
   async execute(args, ctx) {
     const state = requireState(ctx.sessionID);
     await checkRateLimit(state.agentName, "reserve");
+    if (!args.ttl_seconds || args.ttl_seconds <= 0) {
+      throw new AgentMailError("ttl_seconds is required for file reservations", "file_reservation_paths");
+    }
     const result = await mcpCall("file_reservation_paths", {
       project_key: state.projectKey,
       agent_name: state.agentName,
       paths: args.paths,
-      ttl_seconds: args.ttl_seconds || DEFAULT_TTL_SECONDS,
+      ttl_seconds: args.ttl_seconds,
       exclusive: args.exclusive ?? true,
       reason: args.reason || ""
     });
@@ -61197,11 +61267,13 @@ var agentmail_release = tool({
   async execute(args, ctx) {
     const state = requireState(ctx.sessionID);
     await checkRateLimit(state.agentName, "release");
+    const shouldUseStoredIds = !args.paths && (!args.reservation_ids || args.reservation_ids.length === 0);
+    const reservationIds = shouldUseStoredIds && state.reservations.length > 0 ? state.reservations : args.reservation_ids;
     const result = await mcpCall("release_file_reservations", {
       project_key: state.projectKey,
       agent_name: state.agentName,
       paths: args.paths,
-      file_reservation_ids: args.reservation_ids
+      file_reservation_ids: reservationIds
     });
     state.reservations = [];
     setState(ctx.sessionID, state);
@@ -61327,6 +61399,260 @@ import {
   checkSwarmHealth as checkSwarmHealth2,
   getActiveReservations
 } from "swarm-mail";
+
+// src/planning-guardrails.ts
+init_eval_capture();
+var FILE_MODIFICATION_PATTERNS = [
+  /\bimplement\b/i,
+  /\bcreate\b.*\.(ts|js|tsx|jsx|py|rs|go|java|rb|swift|kt)/i,
+  /\badd\b.*\.(ts|js|tsx|jsx|py|rs|go|java|rb|swift|kt)/i,
+  /\bupdate\b.*\.(ts|js|tsx|jsx|py|rs|go|java|rb|swift|kt)/i,
+  /\bmodify\b/i,
+  /\brefactor\b/i,
+  /\bextract\b/i,
+  /\bmigrate\b/i,
+  /\bconvert\b/i,
+  /\brewrite\b/i,
+  /\bfix\b.*\.(ts|js|tsx|jsx|py|rs|go|java|rb|swift|kt)/i,
+  /\bwrite\b.*\.(ts|js|tsx|jsx|py|rs|go|java|rb|swift|kt)/i,
+  /src\//i,
+  /lib\//i,
+  /packages?\//i,
+  /components?\//i
+];
+var TRACKING_PATTERNS = [
+  /\breview\b/i,
+  /\bcheck\b/i,
+  /\bverify\b/i,
+  /\btest\b.*pass/i,
+  /\brun\b.*test/i,
+  /\bdeploy\b/i,
+  /\bmerge\b/i,
+  /\bpr\b/i,
+  /\bpush\b/i,
+  /\bcommit\b/i
+];
+function analyzeTodoWrite(args) {
+  const todos = args.todos;
+  if (!todos || !Array.isArray(todos) || todos.length < 6) {
+    return {
+      looksLikeParallelWork: false,
+      fileModificationCount: 0,
+      totalCount: todos?.length ?? 0
+    };
+  }
+  let fileModificationCount = 0;
+  for (const todo of todos) {
+    if (typeof todo !== "object" || todo === null)
+      continue;
+    const content = todo.content ?? "";
+    const isFileModification = FILE_MODIFICATION_PATTERNS.some((pattern) => pattern.test(content));
+    const isTracking = TRACKING_PATTERNS.some((pattern) => pattern.test(content));
+    if (isFileModification && !isTracking) {
+      fileModificationCount++;
+    }
+  }
+  const ratio = fileModificationCount / todos.length;
+  const looksLikeParallelWork = ratio >= 0.5 && fileModificationCount >= 4;
+  if (looksLikeParallelWork) {
+    return {
+      looksLikeParallelWork: true,
+      fileModificationCount,
+      totalCount: todos.length,
+      warning: `⚠️  This looks like a multi-file implementation plan (${fileModificationCount}/${todos.length} items are file modifications).
+
+Consider using swarm instead:
+  swarm_decompose → hive_create_epic → parallel task spawns
+
+TodoWrite is for tracking progress, not parallelizable implementation work.
+Swarm workers can complete these ${fileModificationCount} tasks in parallel.
+
+(Continuing with todowrite - this is just a suggestion)`
+    };
+  }
+  return {
+    looksLikeParallelWork: false,
+    fileModificationCount,
+    totalCount: todos.length
+  };
+}
+function shouldAnalyzeTool(toolName) {
+  return toolName === "todowrite" || toolName === "TodoWrite";
+}
+var VIOLATION_PATTERNS = {
+  FILE_MODIFICATION_TOOLS: ["edit", "write"],
+  RESERVATION_TOOLS: ["swarmmail_reserve", "agentmail_reserve"],
+  TEST_EXECUTION_PATTERNS: [
+    /\bbun\s+test\b/i,
+    /\bnpm\s+(run\s+)?test/i,
+    /\byarn\s+(run\s+)?test/i,
+    /\bpnpm\s+(run\s+)?test/i,
+    /\bjest\b/i,
+    /\bvitest\b/i,
+    /\bmocha\b/i,
+    /\bava\b/i,
+    /\btape\b/i,
+    /\.test\.(ts|js|tsx|jsx)\b/i,
+    /\.spec\.(ts|js|tsx|jsx)\b/i
+  ]
+};
+function detectCoordinatorViolation(params) {
+  const { sessionId, epicId, toolName, toolArgs, agentContext, checkNoSpawn = false } = params;
+  if (agentContext !== "coordinator") {
+    return { isViolation: false };
+  }
+  if (VIOLATION_PATTERNS.FILE_MODIFICATION_TOOLS.includes(toolName)) {
+    const file2 = toolArgs.filePath || "";
+    const payload = { tool: toolName, file: file2 };
+    captureCoordinatorEvent({
+      session_id: sessionId,
+      epic_id: epicId,
+      timestamp: new Date().toISOString(),
+      event_type: "VIOLATION",
+      violation_type: "coordinator_edited_file",
+      payload
+    });
+    return {
+      isViolation: true,
+      violationType: "coordinator_edited_file",
+      message: `⚠️ Coordinator should not edit files directly. Coordinators should spawn workers to implement changes.`,
+      payload
+    };
+  }
+  if (toolName === "bash") {
+    const command = toolArgs.command || "";
+    const isTestCommand = VIOLATION_PATTERNS.TEST_EXECUTION_PATTERNS.some((pattern) => pattern.test(command));
+    if (isTestCommand) {
+      const payload = { tool: toolName, command };
+      captureCoordinatorEvent({
+        session_id: sessionId,
+        epic_id: epicId,
+        timestamp: new Date().toISOString(),
+        event_type: "VIOLATION",
+        violation_type: "coordinator_ran_tests",
+        payload
+      });
+      return {
+        isViolation: true,
+        violationType: "coordinator_ran_tests",
+        message: `⚠️ Coordinator should not run tests directly. Workers run tests as part of their implementation verification.`,
+        payload
+      };
+    }
+  }
+  if (VIOLATION_PATTERNS.RESERVATION_TOOLS.includes(toolName)) {
+    const paths = toolArgs.paths || [];
+    const payload = { tool: toolName, paths };
+    captureCoordinatorEvent({
+      session_id: sessionId,
+      epic_id: epicId,
+      timestamp: new Date().toISOString(),
+      event_type: "VIOLATION",
+      violation_type: "coordinator_reserved_files",
+      payload
+    });
+    return {
+      isViolation: true,
+      violationType: "coordinator_reserved_files",
+      message: `⚠️ Coordinator should not reserve files. Workers reserve files before editing to prevent conflicts.`,
+      payload
+    };
+  }
+  if (toolName === "hive_create_epic" && checkNoSpawn) {
+    const epicTitle = toolArgs.epic_title || "";
+    const subtasks = toolArgs.subtasks || [];
+    const payload = { epic_title: epicTitle, subtask_count: subtasks.length };
+    captureCoordinatorEvent({
+      session_id: sessionId,
+      epic_id: epicId,
+      timestamp: new Date().toISOString(),
+      event_type: "VIOLATION",
+      violation_type: "no_worker_spawned",
+      payload
+    });
+    return {
+      isViolation: true,
+      violationType: "no_worker_spawned",
+      message: `⚠️ Coordinator created decomposition without spawning workers. After hive_create_epic, use swarm_spawn_subtask for each task.`,
+      payload
+    };
+  }
+  if (toolName === "swarm_complete" || toolName === "hive_close") {
+    const payload = { tool: toolName };
+    captureCoordinatorEvent({
+      session_id: sessionId,
+      epic_id: epicId,
+      timestamp: new Date().toISOString(),
+      event_type: "VIOLATION",
+      violation_type: "worker_completed_without_review",
+      payload
+    });
+    return {
+      isViolation: true,
+      violationType: "worker_completed_without_review",
+      message: `⚠️ Coordinator should not complete worker tasks directly. Coordinators should review worker output using swarm_review and swarm_review_feedback.`,
+      payload
+    };
+  }
+  return { isViolation: false };
+}
+var coordinatorContexts = new Map;
+var globalCoordinatorContext = {
+  isCoordinator: false
+};
+function setCoordinatorContext(ctx) {
+  const sessionId = ctx.sessionId;
+  if (sessionId) {
+    const existing = coordinatorContexts.get(sessionId) || { isCoordinator: false };
+    coordinatorContexts.set(sessionId, {
+      ...existing,
+      ...ctx,
+      activatedAt: ctx.isCoordinator ? Date.now() : existing.activatedAt
+    });
+  } else {
+    globalCoordinatorContext = {
+      ...globalCoordinatorContext,
+      ...ctx,
+      activatedAt: ctx.isCoordinator ? Date.now() : globalCoordinatorContext.activatedAt
+    };
+  }
+}
+function getCoordinatorContext(sessionId) {
+  if (sessionId) {
+    return { ...coordinatorContexts.get(sessionId) || { isCoordinator: false } };
+  }
+  return { ...globalCoordinatorContext };
+}
+function clearCoordinatorContext(sessionId) {
+  if (sessionId) {
+    coordinatorContexts.delete(sessionId);
+  } else {
+    globalCoordinatorContext = {
+      isCoordinator: false
+    };
+  }
+}
+function isInCoordinatorContext(sessionId) {
+  const ctx = sessionId ? coordinatorContexts.get(sessionId) : globalCoordinatorContext;
+  if (!ctx || !ctx.isCoordinator) {
+    return false;
+  }
+  const COORDINATOR_TIMEOUT_MS = 4 * 60 * 60 * 1000;
+  if (ctx.activatedAt) {
+    const elapsed = Date.now() - ctx.activatedAt;
+    if (elapsed > COORDINATOR_TIMEOUT_MS) {
+      if (sessionId) {
+        coordinatorContexts.delete(sessionId);
+      } else {
+        globalCoordinatorContext = { isCoordinator: false };
+      }
+      return false;
+    }
+  }
+  return true;
+}
+
+// src/swarm-mail.ts
 import {
   existsSync as existsSync5,
   mkdirSync as mkdirSync4,
@@ -61382,6 +61708,21 @@ function clearSessionState(sessionID) {
     }
   } catch {}
 }
+function hasCoordinatorOverride(sessionID) {
+  return isInCoordinatorContext(sessionID) || isInCoordinatorContext();
+}
+function formatCoordinatorOverrideError(params) {
+  return JSON.stringify({
+    error: "Coordinator-only override. Ask the coordinator to use this tool for stale or orphaned reservations.",
+    guard: "coordinator_only",
+    required_context: "coordinator",
+    tool: params.tool,
+    agent_name: params.state.agentName,
+    project_key: params.state.projectKey,
+    session_id: params.sessionID,
+    suggestion: "If reservations are stale, notify the coordinator via swarmmail_send before releasing."
+  }, null, 2);
+}
 var swarmmail_init = tool({
   description: "Initialize Swarm Mail session. Creates agent identity and registers with the embedded event store.",
   args: {
@@ -61636,6 +61977,13 @@ var swarmmail_release_all = tool({
     if (!state) {
       return JSON.stringify({ error: "Session not initialized. Call swarmmail_init first." }, null, 2);
     }
+    if (!hasCoordinatorOverride(sessionID)) {
+      return formatCoordinatorOverrideError({
+        tool: "swarmmail_release_all",
+        state,
+        sessionID
+      });
+    }
     try {
       const result = await releaseAllSwarmFiles({
         projectPath: state.projectKey,
@@ -61666,6 +62014,13 @@ var swarmmail_release_agent = tool({
     if (!state) {
       return JSON.stringify({ error: "Session not initialized. Call swarmmail_init first." }, null, 2);
     }
+    if (!hasCoordinatorOverride(sessionID)) {
+      return formatCoordinatorOverrideError({
+        tool: "swarmmail_release_agent",
+        state,
+        sessionID
+      });
+    }
     try {
       const result = await releaseSwarmFilesForAgent({
         projectPath: state.projectKey,
@@ -68015,7 +68370,8 @@ var swarm_spawn_subtask = tool({
       files: args2.files,
       shared_context: args2.shared_context,
       project_path: args2.project_path,
-      recovery_context: args2.recovery_context
+      recovery_context: args2.recovery_context,
+      model: args2.model
     });
     const { selectWorkerModel: selectWorkerModel2 } = await Promise.resolve().then(() => exports_model_selection);
     const subtask = {
@@ -70779,258 +71135,6 @@ function createMetrics(result, toolName) {
   };
 }
 
-// src/planning-guardrails.ts
-init_eval_capture();
-var FILE_MODIFICATION_PATTERNS = [
-  /\bimplement\b/i,
-  /\bcreate\b.*\.(ts|js|tsx|jsx|py|rs|go|java|rb|swift|kt)/i,
-  /\badd\b.*\.(ts|js|tsx|jsx|py|rs|go|java|rb|swift|kt)/i,
-  /\bupdate\b.*\.(ts|js|tsx|jsx|py|rs|go|java|rb|swift|kt)/i,
-  /\bmodify\b/i,
-  /\brefactor\b/i,
-  /\bextract\b/i,
-  /\bmigrate\b/i,
-  /\bconvert\b/i,
-  /\brewrite\b/i,
-  /\bfix\b.*\.(ts|js|tsx|jsx|py|rs|go|java|rb|swift|kt)/i,
-  /\bwrite\b.*\.(ts|js|tsx|jsx|py|rs|go|java|rb|swift|kt)/i,
-  /src\//i,
-  /lib\//i,
-  /packages?\//i,
-  /components?\//i
-];
-var TRACKING_PATTERNS = [
-  /\breview\b/i,
-  /\bcheck\b/i,
-  /\bverify\b/i,
-  /\btest\b.*pass/i,
-  /\brun\b.*test/i,
-  /\bdeploy\b/i,
-  /\bmerge\b/i,
-  /\bpr\b/i,
-  /\bpush\b/i,
-  /\bcommit\b/i
-];
-function analyzeTodoWrite(args2) {
-  const todos = args2.todos;
-  if (!todos || !Array.isArray(todos) || todos.length < 6) {
-    return {
-      looksLikeParallelWork: false,
-      fileModificationCount: 0,
-      totalCount: todos?.length ?? 0
-    };
-  }
-  let fileModificationCount = 0;
-  for (const todo of todos) {
-    if (typeof todo !== "object" || todo === null)
-      continue;
-    const content = todo.content ?? "";
-    const isFileModification = FILE_MODIFICATION_PATTERNS.some((pattern2) => pattern2.test(content));
-    const isTracking = TRACKING_PATTERNS.some((pattern2) => pattern2.test(content));
-    if (isFileModification && !isTracking) {
-      fileModificationCount++;
-    }
-  }
-  const ratio = fileModificationCount / todos.length;
-  const looksLikeParallelWork = ratio >= 0.5 && fileModificationCount >= 4;
-  if (looksLikeParallelWork) {
-    return {
-      looksLikeParallelWork: true,
-      fileModificationCount,
-      totalCount: todos.length,
-      warning: `⚠️  This looks like a multi-file implementation plan (${fileModificationCount}/${todos.length} items are file modifications).
-
-Consider using swarm instead:
-  swarm_decompose → hive_create_epic → parallel task spawns
-
-TodoWrite is for tracking progress, not parallelizable implementation work.
-Swarm workers can complete these ${fileModificationCount} tasks in parallel.
-
-(Continuing with todowrite - this is just a suggestion)`
-    };
-  }
-  return {
-    looksLikeParallelWork: false,
-    fileModificationCount,
-    totalCount: todos.length
-  };
-}
-function shouldAnalyzeTool(toolName) {
-  return toolName === "todowrite" || toolName === "TodoWrite";
-}
-var VIOLATION_PATTERNS = {
-  FILE_MODIFICATION_TOOLS: ["edit", "write"],
-  RESERVATION_TOOLS: ["swarmmail_reserve", "agentmail_reserve"],
-  TEST_EXECUTION_PATTERNS: [
-    /\bbun\s+test\b/i,
-    /\bnpm\s+(run\s+)?test/i,
-    /\byarn\s+(run\s+)?test/i,
-    /\bpnpm\s+(run\s+)?test/i,
-    /\bjest\b/i,
-    /\bvitest\b/i,
-    /\bmocha\b/i,
-    /\bava\b/i,
-    /\btape\b/i,
-    /\.test\.(ts|js|tsx|jsx)\b/i,
-    /\.spec\.(ts|js|tsx|jsx)\b/i
-  ]
-};
-function detectCoordinatorViolation(params) {
-  const { sessionId, epicId, toolName, toolArgs, agentContext, checkNoSpawn = false } = params;
-  if (agentContext !== "coordinator") {
-    return { isViolation: false };
-  }
-  if (VIOLATION_PATTERNS.FILE_MODIFICATION_TOOLS.includes(toolName)) {
-    const file2 = toolArgs.filePath || "";
-    const payload = { tool: toolName, file: file2 };
-    captureCoordinatorEvent({
-      session_id: sessionId,
-      epic_id: epicId,
-      timestamp: new Date().toISOString(),
-      event_type: "VIOLATION",
-      violation_type: "coordinator_edited_file",
-      payload
-    });
-    return {
-      isViolation: true,
-      violationType: "coordinator_edited_file",
-      message: `⚠️ Coordinator should not edit files directly. Coordinators should spawn workers to implement changes.`,
-      payload
-    };
-  }
-  if (toolName === "bash") {
-    const command = toolArgs.command || "";
-    const isTestCommand = VIOLATION_PATTERNS.TEST_EXECUTION_PATTERNS.some((pattern2) => pattern2.test(command));
-    if (isTestCommand) {
-      const payload = { tool: toolName, command };
-      captureCoordinatorEvent({
-        session_id: sessionId,
-        epic_id: epicId,
-        timestamp: new Date().toISOString(),
-        event_type: "VIOLATION",
-        violation_type: "coordinator_ran_tests",
-        payload
-      });
-      return {
-        isViolation: true,
-        violationType: "coordinator_ran_tests",
-        message: `⚠️ Coordinator should not run tests directly. Workers run tests as part of their implementation verification.`,
-        payload
-      };
-    }
-  }
-  if (VIOLATION_PATTERNS.RESERVATION_TOOLS.includes(toolName)) {
-    const paths = toolArgs.paths || [];
-    const payload = { tool: toolName, paths };
-    captureCoordinatorEvent({
-      session_id: sessionId,
-      epic_id: epicId,
-      timestamp: new Date().toISOString(),
-      event_type: "VIOLATION",
-      violation_type: "coordinator_reserved_files",
-      payload
-    });
-    return {
-      isViolation: true,
-      violationType: "coordinator_reserved_files",
-      message: `⚠️ Coordinator should not reserve files. Workers reserve files before editing to prevent conflicts.`,
-      payload
-    };
-  }
-  if (toolName === "hive_create_epic" && checkNoSpawn) {
-    const epicTitle = toolArgs.epic_title || "";
-    const subtasks = toolArgs.subtasks || [];
-    const payload = { epic_title: epicTitle, subtask_count: subtasks.length };
-    captureCoordinatorEvent({
-      session_id: sessionId,
-      epic_id: epicId,
-      timestamp: new Date().toISOString(),
-      event_type: "VIOLATION",
-      violation_type: "no_worker_spawned",
-      payload
-    });
-    return {
-      isViolation: true,
-      violationType: "no_worker_spawned",
-      message: `⚠️ Coordinator created decomposition without spawning workers. After hive_create_epic, use swarm_spawn_subtask for each task.`,
-      payload
-    };
-  }
-  if (toolName === "swarm_complete" || toolName === "hive_close") {
-    const payload = { tool: toolName };
-    captureCoordinatorEvent({
-      session_id: sessionId,
-      epic_id: epicId,
-      timestamp: new Date().toISOString(),
-      event_type: "VIOLATION",
-      violation_type: "worker_completed_without_review",
-      payload
-    });
-    return {
-      isViolation: true,
-      violationType: "worker_completed_without_review",
-      message: `⚠️ Coordinator should not complete worker tasks directly. Coordinators should review worker output using swarm_review and swarm_review_feedback.`,
-      payload
-    };
-  }
-  return { isViolation: false };
-}
-var coordinatorContexts = new Map;
-var globalCoordinatorContext = {
-  isCoordinator: false
-};
-function setCoordinatorContext(ctx) {
-  const sessionId = ctx.sessionId;
-  if (sessionId) {
-    const existing = coordinatorContexts.get(sessionId) || { isCoordinator: false };
-    coordinatorContexts.set(sessionId, {
-      ...existing,
-      ...ctx,
-      activatedAt: ctx.isCoordinator ? Date.now() : existing.activatedAt
-    });
-  } else {
-    globalCoordinatorContext = {
-      ...globalCoordinatorContext,
-      ...ctx,
-      activatedAt: ctx.isCoordinator ? Date.now() : globalCoordinatorContext.activatedAt
-    };
-  }
-}
-function getCoordinatorContext(sessionId) {
-  if (sessionId) {
-    return { ...coordinatorContexts.get(sessionId) || { isCoordinator: false } };
-  }
-  return { ...globalCoordinatorContext };
-}
-function clearCoordinatorContext(sessionId) {
-  if (sessionId) {
-    coordinatorContexts.delete(sessionId);
-  } else {
-    globalCoordinatorContext = {
-      isCoordinator: false
-    };
-  }
-}
-function isInCoordinatorContext(sessionId) {
-  const ctx = sessionId ? coordinatorContexts.get(sessionId) : globalCoordinatorContext;
-  if (!ctx || !ctx.isCoordinator) {
-    return false;
-  }
-  const COORDINATOR_TIMEOUT_MS = 4 * 60 * 60 * 1000;
-  if (ctx.activatedAt) {
-    const elapsed = Date.now() - ctx.activatedAt;
-    if (elapsed > COORDINATOR_TIMEOUT_MS) {
-      if (sessionId) {
-        coordinatorContexts.delete(sessionId);
-      } else {
-        globalCoordinatorContext = { isCoordinator: false };
-      }
-      return false;
-    }
-  }
-  return true;
-}
-
 // src/coordinator-guard.ts
 class CoordinatorGuardError extends Error {
   violationType;
@@ -71298,6 +71402,7 @@ var logger = getLogger();
 
 // src/compaction-hook.ts
 init_eval_capture();
+init_skills();
 var _logger;
 function getLog() {
   if (!_logger) {
@@ -71319,6 +71424,9 @@ Context was compacted but the swarm is still running. **YOU ARE THE COORDINATOR.
 
 Your role is ORCHESTRATION, not implementation. The resume steps above (if present) tell you exactly what to do first.
 
+## \uD83D\uDD27 ALWAYS-ON GUIDANCE
+${getAlwaysOnGuidanceSkill({ role: "coordinator" })}
+
 ---
 
 ## \uD83C\uDFAF WHAT GOOD LOOKS LIKE (Behavioral Examples)
@@ -71375,10 +71483,12 @@ You are the **COORDINATOR**. Your job is ORCHESTRATION, not implementation.
 ### What Coordinators Do:
 - ✅ Spawn workers for implementation tasks
 - ✅ Monitor worker progress via \`swarm_status\` and \`swarmmail_inbox\`
+- ✅ Use \`swarmmail_release_all\` to clear stale/orphaned reservations (coordinator override)
 - ✅ Review completed work with \`swarm_review\`
 - ✅ Unblock dependencies and resolve conflicts
 - ✅ Close the loop when epics complete
 
+
 ### What Coordinators NEVER Do:
 - ❌ **NEVER** edit or write files directly
 - ❌ **NEVER** run tests with \`bash\`