opencode-swarm-plugin 0.57.6 → 0.59.0

package/dist/swarm-prompts.js

@@ -17875,13 +17875,13 @@ Scripts run in the skill's directory with the project directory as an argument.`
       }
       const scriptPath = join3(skill.directory, "scripts", args.script);
       const scriptArgs = args.args || [];
+      const TIMEOUT_MS = 60000;
+      const proc = Bun.spawn([scriptPath, skillsProjectDirectory, ...scriptArgs], {
+        cwd: skill.directory,
+        stdout: "pipe",
+        stderr: "pipe"
+      });
       try {
-        const TIMEOUT_MS = 60000;
-        const proc = Bun.spawn([scriptPath, skillsProjectDirectory, ...scriptArgs], {
-          cwd: skill.directory,
-          stdout: "pipe",
-          stderr: "pipe"
-        });
         const timeoutPromise = new Promise((resolve2) => {
           setTimeout(() => resolve2({ timedOut: true }), TIMEOUT_MS);
         });
@@ -17895,7 +17895,6 @@ Scripts run in the skill's directory with the project directory as an argument.`
         })();
         const result = await Promise.race([resultPromise, timeoutPromise]);
         if (result.timedOut) {
-          proc.kill();
           return `Script timed out after ${TIMEOUT_MS / 1000} seconds.`;
         }
         const output = result.stdout + result.stderr;
@@ -17907,6 +17906,8 @@ ${output}`;
         }
       } catch (error45) {
         return `Failed to execute script: ${error45 instanceof Error ? error45.message : String(error45)}`;
+      } finally {
+        proc.kill();
       }
     }
   });
@@ -18284,6 +18285,237 @@ echo "Project directory: $1"
   };
 });
 
+// src/decision-trace-integration.ts
+var exports_decision_trace_integration = {};
+__export(exports_decision_trace_integration, {
+  traceWorkerSpawn: () => traceWorkerSpawn,
+  traceStrategySelection: () => traceStrategySelection,
+  traceScopeChange: () => traceScopeChange,
+  traceReviewDecision: () => traceReviewDecision,
+  traceFileSelection: () => traceFileSelection,
+  linkOutcomeToDecisionTrace: () => linkOutcomeToDecisionTrace,
+  getEpicDecisionTraces: () => getEpicDecisionTraces,
+  getDecisionTracesByType: () => getDecisionTracesByType,
+  extractMemoryIds: () => extractMemoryIds
+});
+import {
+  createDecisionTrace,
+  createEntityLink
+} from "swarm-mail";
+import { createLibSQLAdapter } from "swarm-mail";
+import { getDatabasePath } from "swarm-mail";
+async function getTraceDb(projectPath) {
+  const dbPath = getDatabasePath(projectPath);
+  return createLibSQLAdapter({ url: `file:${dbPath}` });
+}
+function extractMemoryIds(precedentCited) {
+  if (!precedentCited) {
+    return [];
+  }
+  if (precedentCited.memoryIds && Array.isArray(precedentCited.memoryIds)) {
+    return precedentCited.memoryIds;
+  }
+  if (precedentCited.memoryId) {
+    return [precedentCited.memoryId];
+  }
+  return [];
+}
+async function traceStrategySelection(input) {
+  try {
+    const db = await getTraceDb(input.projectKey);
+    const trace = await createDecisionTrace(db, {
+      decision_type: "strategy_selection",
+      epic_id: input.epicId,
+      bead_id: input.beadId,
+      agent_name: input.agentName,
+      project_key: input.projectKey,
+      decision: {
+        strategy: input.strategy,
+        confidence: input.confidence,
+        task_preview: input.taskPreview
+      },
+      rationale: input.reasoning,
+      inputs_gathered: input.inputsGathered,
+      alternatives: input.alternatives,
+      precedent_cited: input.precedentCited
+    });
+    const memoryIds = extractMemoryIds(input.precedentCited);
+    for (const memoryId of memoryIds) {
+      await createEntityLink(db, {
+        source_decision_id: trace.id,
+        target_entity_type: "memory",
+        target_entity_id: memoryId,
+        link_type: "cites_precedent",
+        strength: input.precedentCited?.similarity ?? 1,
+        context: "Cited as precedent for strategy selection"
+      });
+    }
+    await db.close?.();
+    return trace.id;
+  } catch (error45) {
+    console.warn("[decision-trace] Failed to trace strategy_selection:", error45);
+    return "";
+  }
+}
+async function traceWorkerSpawn(input) {
+  try {
+    const db = await getTraceDb(input.projectKey);
+    const trace = await createDecisionTrace(db, {
+      decision_type: "worker_spawn",
+      epic_id: input.epicId,
+      bead_id: input.beadId,
+      agent_name: input.agentName,
+      project_key: input.projectKey,
+      decision: {
+        worker: input.workerName || "worker",
+        subtask_title: input.subtaskTitle,
+        files: input.files,
+        model: input.model,
+        spawn_order: input.spawnOrder,
+        is_parallel: input.isParallel
+      },
+      rationale: input.rationale || `Spawning worker for: ${input.subtaskTitle}`
+    });
+    for (const file2 of input.files) {
+      await createEntityLink(db, {
+        source_decision_id: trace.id,
+        target_entity_type: "file",
+        target_entity_id: file2,
+        link_type: "assigns_file",
+        strength: 1,
+        context: `File assigned to worker ${input.workerName || "worker"}`
+      });
+    }
+    await db.close?.();
+    return trace.id;
+  } catch (error45) {
+    console.warn("[decision-trace] Failed to trace worker_spawn:", error45);
+    return "";
+  }
+}
+async function traceReviewDecision(input) {
+  try {
+    const db = await getTraceDb(input.projectKey);
+    const trace = await createDecisionTrace(db, {
+      decision_type: "review_decision",
+      epic_id: input.epicId,
+      bead_id: input.beadId,
+      agent_name: input.agentName,
+      project_key: input.projectKey,
+      decision: {
+        status: input.status,
+        worker_id: input.workerId,
+        issues_count: input.issues?.length || 0,
+        attempt_number: input.attemptNumber,
+        remaining_attempts: input.remainingAttempts
+      },
+      rationale: input.rationale || input.summary || `Review ${input.status}`,
+      inputs_gathered: input.issues ? [{ source: "code_review", issues: input.issues }] : undefined
+    });
+    await createEntityLink(db, {
+      source_decision_id: trace.id,
+      target_entity_type: "agent",
+      target_entity_id: input.workerId,
+      link_type: "reviewed_work_by",
+      strength: 1,
+      context: `Review ${input.status} for ${input.workerId}`
+    });
+    await db.close?.();
+    return trace.id;
+  } catch (error45) {
+    console.warn("[decision-trace] Failed to trace review_decision:", error45);
+    return "";
+  }
+}
+async function traceFileSelection(input) {
+  try {
+    const db = await getTraceDb(input.projectKey);
+    const trace = await createDecisionTrace(db, {
+      decision_type: "file_selection",
+      epic_id: input.epicId,
+      bead_id: input.beadId,
+      agent_name: input.agentName,
+      project_key: input.projectKey,
+      decision: {
+        files_selected: input.filesSelected,
+        files_owned: input.filesOwned,
+        scope_expanded: input.scopeExpanded
+      },
+      rationale: input.rationale || `Selected ${input.filesSelected.length} files`
+    });
+    await db.close?.();
+    return trace.id;
+  } catch (error45) {
+    console.warn("[decision-trace] Failed to trace file_selection:", error45);
+    return "";
+  }
+}
+async function traceScopeChange(input) {
+  try {
+    const db = await getTraceDb(input.projectKey);
+    const trace = await createDecisionTrace(db, {
+      decision_type: "scope_change",
+      epic_id: input.epicId,
+      bead_id: input.beadId,
+      agent_name: input.agentName,
+      project_key: input.projectKey,
+      decision: {
+        files_added: input.filesAdded || [],
+        files_removed: input.filesRemoved || [],
+        coordinator_approved: input.coordinatorApproved
+      },
+      rationale: input.reason
+    });
+    await db.close?.();
+    return trace.id;
+  } catch (error45) {
+    console.warn("[decision-trace] Failed to trace scope_change:", error45);
+    return "";
+  }
+}
+async function getEpicDecisionTraces(projectKey, epicId) {
+  try {
+    const { getDecisionTracesByEpic } = await import("swarm-mail");
+    const db = await getTraceDb(projectKey);
+    const traces = await getDecisionTracesByEpic(db, epicId);
+    await db.close?.();
+    return traces;
+  } catch (error45) {
+    console.warn("[decision-trace] Failed to query epic traces:", error45);
+    return [];
+  }
+}
+async function getDecisionTracesByType(projectKey, decisionType) {
+  try {
+    const { getDecisionTracesByType: queryByType } = await import("swarm-mail");
+    const db = await getTraceDb(projectKey);
+    const traces = await queryByType(db, decisionType);
+    await db.close?.();
+    return traces;
+  } catch (error45) {
+    console.warn("[decision-trace] Failed to query traces by type:", error45);
+    return [];
+  }
+}
+async function linkOutcomeToDecisionTrace(input) {
+  try {
+    const { findDecisionTraceByBead, linkOutcomeToTrace } = await import("swarm-mail");
+    const db = await getTraceDb(input.projectKey);
+    const trace = await findDecisionTraceByBead(db, input.beadId);
+    if (!trace) {
+      await db.close?.();
+      return false;
+    }
+    await linkOutcomeToTrace(db, trace.id, input.outcomeEventId);
+    await db.close?.();
+    return true;
+  } catch (error45) {
+    console.warn("[decision-trace] Failed to link outcome to trace:", error45);
+    return false;
+  }
+}
+var init_decision_trace_integration = () => {};
+
 // src/anti-patterns.ts
 var exports_anti_patterns = {};
 __export(exports_anti_patterns, {
@@ -18809,9 +19041,11 @@ async function execSemanticMemory(args) {
       stderr: "pipe"
     });
     try {
+      const TIMEOUT_MS = 30000;
+      const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error("Process timed out after 30s")), TIMEOUT_MS));
       const stdout = Buffer.from(await new Response(proc.stdout).arrayBuffer());
       const stderr = Buffer.from(await new Response(proc.stderr).arrayBuffer());
-      const exitCode = await proc.exited;
+      const exitCode = await Promise.race([proc.exited, timeoutPromise]);
       return { exitCode, stdout, stderr };
     } finally {
       proc.kill();
@@ -39785,13 +40019,17 @@ var toolCheckers = {
         stderr: "pipe"
       });
       const timeout = setTimeout(() => proc.kill(), BUNX_TIMEOUT_MS);
-      const exitCode = await proc.exited;
-      clearTimeout(timeout);
-      return {
-        available: exitCode === 0,
-        checkedAt: new Date().toISOString(),
-        version: "bunx"
-      };
+      try {
+        const exitCode = await proc.exited;
+        return {
+          available: exitCode === 0,
+          checkedAt: new Date().toISOString(),
+          version: "bunx"
+        };
+      } finally {
+        clearTimeout(timeout);
+        proc.kill();
+      }
     } catch (e) {
       return {
         available: false,
@@ -39864,13 +40102,17 @@ var toolCheckers = {
         stderr: "pipe"
       });
       const timeout = setTimeout(() => proc.kill(), BUNX_TIMEOUT_MS);
-      const exitCode = await proc.exited;
-      clearTimeout(timeout);
-      return {
-        available: exitCode === 0,
-        checkedAt: new Date().toISOString(),
-        version: "bunx-semantic-memory"
-      };
+      try {
+        const exitCode = await proc.exited;
+        return {
+          available: exitCode === 0,
+          checkedAt: new Date().toISOString(),
+          version: "bunx-semantic-memory"
+        };
+      } finally {
+        clearTimeout(timeout);
+        proc.kill();
+      }
     } catch (e) {
       return {
         available: false,
@@ -40034,12 +40276,16 @@ async function runGitCommand(args) {
     stdout: "pipe",
     stderr: "pipe"
   });
-  const [stdout, stderr] = await Promise.all([
-    new Response(proc.stdout).text(),
-    new Response(proc.stderr).text()
-  ]);
-  const exitCode = await proc.exited;
-  return { exitCode, stdout, stderr };
+  try {
+    const [stdout, stderr] = await Promise.all([
+      new Response(proc.stdout).text(),
+      new Response(proc.stderr).text()
+    ]);
+    const exitCode = await proc.exited;
+    return { exitCode, stdout, stderr };
+  } finally {
+    proc.kill();
+  }
 }
 
 class HiveError extends Error {
@@ -40196,9 +40442,9 @@ var hive_create = tool({
   }
 });
 var hive_create_epic = tool({
-  description: "Create epic with subtasks in one atomic operation",
+  description: "Create epic with subtasks atomically. REQUIRED: epic_title, subtasks (array with {title, files?}). Use after swarm_validate_decomposition confirms your decomposition is valid. Each subtask should list files it will modify to enable parallel work without conflicts.",
   args: {
-    epic_title: tool.schema.string().describe("Epic title"),
+    epic_title: tool.schema.string().describe("Epic title (e.g., 'Implement user auth')"),
     epic_description: tool.schema.string().optional().describe("Epic description"),
     epic_id: tool.schema.string().optional().describe("Custom ID for the epic (e.g., 'phase-0')"),
     subtasks: tool.schema.array(tool.schema.object({
@@ -40217,6 +40463,28 @@ var hive_create_epic = tool({
     }).optional().describe("Recovery context from checkpoint compaction")
   },
   async execute(args, ctx) {
+    const missing = [];
+    if (!args.epic_title)
+      missing.push("epic_title");
+    if (!args.subtasks || args.subtasks.length === 0)
+      missing.push("subtasks (array of subtask objects)");
+    if (missing.length > 0) {
+      return JSON.stringify({
+        success: false,
+        error: `Missing required parameters: ${missing.join(", ")}`,
+        hint: "hive_create_epic creates an epic with subtasks atomically.",
+        example: {
+          epic_title: "Implement user authentication",
+          epic_description: "Add login, logout, and session management",
+          subtasks: [
+            { title: "Create auth service", files: ["src/auth/service.ts"] },
+            { title: "Add login endpoint", files: ["src/api/login.ts"] },
+            { title: "Add session middleware", files: ["src/middleware/session.ts"] }
+          ]
+        },
+        tip: "Each subtask should have a title and optionally files it will modify. This helps with file reservation and parallel execution."
+      }, null, 2);
+    }
     const validated = EpicCreateArgsSchema.parse(args);
     const projectKey = getHiveWorkingDirectory();
     const adapter = await getHiveAdapter(projectKey);
@@ -41270,90 +41538,7 @@ init_dist();
 init_zod();
 import { sendSwarmMessage } from "swarm-mail";
 init_eval_capture();
-
-// src/decision-trace-integration.ts
-import {
-  createDecisionTrace,
-  createEntityLink
-} from "swarm-mail";
-import { createLibSQLAdapter } from "swarm-mail";
-import { getDatabasePath } from "swarm-mail";
-async function getTraceDb(projectPath) {
-  const dbPath = getDatabasePath(projectPath);
-  return createLibSQLAdapter({ url: `file:${dbPath}` });
-}
-async function traceWorkerSpawn(input) {
-  try {
-    const db = await getTraceDb(input.projectKey);
-    const trace = await createDecisionTrace(db, {
-      decision_type: "worker_spawn",
-      epic_id: input.epicId,
-      bead_id: input.beadId,
-      agent_name: input.agentName,
-      project_key: input.projectKey,
-      decision: {
-        worker: input.workerName || "worker",
-        subtask_title: input.subtaskTitle,
-        files: input.files,
-        model: input.model,
-        spawn_order: input.spawnOrder,
-        is_parallel: input.isParallel
-      },
-      rationale: input.rationale || `Spawning worker for: ${input.subtaskTitle}`
-    });
-    for (const file2 of input.files) {
-      await createEntityLink(db, {
-        source_decision_id: trace.id,
-        target_entity_type: "file",
-        target_entity_id: file2,
-        link_type: "assigns_file",
-        strength: 1,
-        context: `File assigned to worker ${input.workerName || "worker"}`
-      });
-    }
-    await db.close?.();
-    return trace.id;
-  } catch (error45) {
-    console.warn("[decision-trace] Failed to trace worker_spawn:", error45);
-    return "";
-  }
-}
-async function traceReviewDecision(input) {
-  try {
-    const db = await getTraceDb(input.projectKey);
-    const trace = await createDecisionTrace(db, {
-      decision_type: "review_decision",
-      epic_id: input.epicId,
-      bead_id: input.beadId,
-      agent_name: input.agentName,
-      project_key: input.projectKey,
-      decision: {
-        status: input.status,
-        worker_id: input.workerId,
-        issues_count: input.issues?.length || 0,
-        attempt_number: input.attemptNumber,
-        remaining_attempts: input.remainingAttempts
-      },
-      rationale: input.rationale || input.summary || `Review ${input.status}`,
-      inputs_gathered: input.issues ? [{ source: "code_review", issues: input.issues }] : undefined
-    });
-    await createEntityLink(db, {
-      source_decision_id: trace.id,
-      target_entity_type: "agent",
-      target_entity_id: input.workerId,
-      link_type: "reviewed_work_by",
-      strength: 1,
-      context: `Review ${input.status} for ${input.workerId}`
-    });
-    await db.close?.();
-    return trace.id;
-  } catch (error45) {
-    console.warn("[decision-trace] Failed to trace review_decision:", error45);
-    return "";
-  }
-}
-
-// src/swarm-review.ts
+init_decision_trace_integration();
 var ReviewIssueSchema = exports_external.object({
   file: exports_external.string(),
   line: exports_external.number().optional(),
@@ -42207,17 +42392,41 @@ var swarm_status = tool({
   }
 });
 var swarm_progress = tool({
-  description: "Report progress on a subtask to coordinator",
+  description: "Report progress on a subtask to coordinator. REQUIRED: project_key, agent_name, bead_id, status. Call periodically (every 25% or when blocked) to keep coordinator informed. Use status='blocked' with message explaining the blocker if you're stuck.",
   args: {
-    project_key: tool.schema.string().describe("Project path"),
-    agent_name: tool.schema.string().describe("Your Agent Mail name"),
-    bead_id: tool.schema.string().describe("Subtask bead ID"),
+    project_key: tool.schema.string().describe("Project path (e.g., '/Users/name/project')"),
+    agent_name: tool.schema.string().describe("Your agent name from swarmmail_init"),
+    bead_id: tool.schema.string().describe("Task ID from your spawn prompt or hive cell"),
     status: tool.schema.enum(["in_progress", "blocked", "completed", "failed"]).describe("Current status"),
     message: tool.schema.string().optional().describe("Progress message or blockers"),
     progress_percent: tool.schema.number().min(0).max(100).optional().describe("Completion percentage"),
     files_touched: tool.schema.array(tool.schema.string()).optional().describe("Files modified so far")
   },
   async execute(args) {
+    const missing = [];
+    if (!args.bead_id)
+      missing.push("bead_id");
+    if (!args.project_key)
+      missing.push("project_key");
+    if (!args.agent_name)
+      missing.push("agent_name");
+    if (!args.status)
+      missing.push("status");
+    if (missing.length > 0) {
+      return JSON.stringify({
+        success: false,
+        error: `Missing required parameters: ${missing.join(", ")}`,
+        hint: "swarm_progress reports task progress to the coordinator.",
+        example: {
+          project_key: "/path/to/project",
+          agent_name: "your-agent-name",
+          bead_id: "your-task-id from spawn",
+          status: "in_progress",
+          progress_percent: 50,
+          message: "Completed X, working on Y"
+        }
+      }, null, 2);
+    }
     const progress = {
       bead_id: args.bead_id,
       agent_name: args.agent_name,
@@ -42343,12 +42552,12 @@ ${args.files_affected.map((f) => `- \`${f}\``).join(`
   }
 });
 var swarm_complete = tool({
-  description: "Mark subtask complete with Verification Gate. Runs typecheck and tests before allowing completion.",
+  description: "Mark subtask complete with Verification Gate. REQUIRED: project_key, agent_name, bead_id (from your task assignment), summary, start_time (Date.now() from when you started). Before calling: 1) hivemind_store your learnings, 2) list files_touched for verification. Runs typecheck/tests before finalizing.",
   args: {
-    project_key: tool.schema.string().describe("Project path"),
-    agent_name: tool.schema.string().describe("Your Agent Mail name"),
-    bead_id: tool.schema.string().describe("Subtask bead ID"),
-    summary: tool.schema.string().describe("Brief summary of work done"),
+    project_key: tool.schema.string().describe("Project path (e.g., '/Users/name/project')"),
+    agent_name: tool.schema.string().describe("Your agent name from swarmmail_init"),
+    bead_id: tool.schema.string().describe("Task ID from your spawn prompt or hive cell"),
+    summary: tool.schema.string().describe("What you accomplished (1-3 sentences)"),
     evaluation: tool.schema.string().optional().describe("Self-evaluation JSON (Evaluation schema)"),
     files_touched: tool.schema.array(tool.schema.string()).optional().describe("Files modified - will be verified (typecheck, tests)"),
     skip_verification: tool.schema.boolean().optional().describe("Skip ALL verification (typecheck, tests). Use sparingly! (default: false)"),
@@ -42359,6 +42568,33 @@ var swarm_complete = tool({
     skip_review: tool.schema.boolean().optional().describe("Skip review gate check (default: false). Use only for tasks that don't require coordinator review.")
   },
   async execute(args, _ctx) {
+    const missing = [];
+    if (!args.bead_id)
+      missing.push("bead_id");
+    if (!args.project_key)
+      missing.push("project_key");
+    if (!args.agent_name)
+      missing.push("agent_name");
+    if (!args.summary)
+      missing.push("summary");
+    if (args.start_time === undefined)
+      missing.push("start_time");
+    if (missing.length > 0) {
+      return JSON.stringify({
+        success: false,
+        error: `Missing required parameters: ${missing.join(", ")}`,
+        hint: "swarm_complete marks a subtask as done. All parameters are required.",
+        example: {
+          project_key: "/path/to/project",
+          agent_name: "your-agent-name",
+          bead_id: "epic-id.subtask-num OR cell-id from hive",
+          summary: "Brief description of what you completed",
+          start_time: Date.now(),
+          files_touched: ["src/file1.ts", "src/file2.ts"]
+        },
+        tip: "The bead_id comes from swarm_spawn_subtask or hive_create. Check your task assignment for the correct ID."
+      }, null, 2);
+    }
     const epicId = args.bead_id.includes(".") ? args.bead_id.split(".")[0] : args.bead_id;
     if (!args.skip_review) {
       const reviewStatusResult = getReviewStatus(args.bead_id);
@@ -42559,6 +42795,7 @@ This will be recorded as a negative learning signal.`;
       }
       const completionDurationMs = Date.now() - args.start_time;
       const eventEpicId = cell.parent_id || (args.bead_id.includes(".") ? args.bead_id.split(".")[0] : args.bead_id);
+      let outcomeEventId;
       try {
         const event = createEvent3("subtask_outcome", {
           project_key: args.project_key,
@@ -42573,10 +42810,23 @@ This will be recorded as a negative learning signal.`;
           scope_violation: contractValidation ? !contractValidation.valid : undefined,
           violation_files: contractValidation?.violations
         });
-        await appendEvent2(event, args.project_key);
+        const savedEvent = await appendEvent2(event, args.project_key);
+        outcomeEventId = savedEvent.id;
       } catch (error45) {
         console.warn("[swarm_complete] Failed to emit SubtaskOutcomeEvent:", error45);
       }
+      if (outcomeEventId) {
+        try {
+          const { linkOutcomeToDecisionTrace: linkOutcomeToDecisionTrace2 } = await Promise.resolve().then(() => (init_decision_trace_integration(), exports_decision_trace_integration));
+          await linkOutcomeToDecisionTrace2({
+            projectKey: args.project_key,
+            beadId: args.bead_id,
+            outcomeEventId
+          });
+        } catch (error45) {
+          console.warn("[swarm_complete] Failed to link outcome to decision trace:", error45);
+        }
+      }
       try {
         const workerCompletedEvent = createEvent3("worker_completed", {
           project_key: args.project_key,
@@ -43538,6 +43788,7 @@ ${skillBody}`, "utf-8");
 // src/swarm-prompts.ts
 init_eval_capture();
 init_memory_tools();
+init_decision_trace_integration();
 var DECOMPOSITION_PROMPT = `You are decomposing a task into parallelizable subtasks for a swarm of agents.
 
 ## Task
@@ -43746,6 +43997,26 @@ Before writing code:
 Begin work on your subtask now.`;
 var SUBTASK_PROMPT_V2 = `You are a swarm agent working on: **{subtask_title}**
 
+╔═══════════════════════════════════════════════════════════════════════════════╗
+║                                                                               ║
+║   \uD83D\uDED1  STOP - READ THIS FIRST - BEFORE ANY EDIT OR WRITE  \uD83D\uDED1                  ║
+║                                                                               ║
+║   You MUST do these 3 things BEFORE your first Edit/Write call:              ║
+║                                                                               ║
+║   1️⃣  hivemind_find(query="<your task keywords>", limit=5, expand=true)      ║
+║       → Check if past agents already solved this                              ║
+║       → Find gotchas, patterns, warnings                                      ║
+║                                                                               ║
+║   2️⃣  skills_list() then skills_use(name="<relevant>")                       ║
+║       → testing-patterns, swarm-coordination, system-design                   ║
+║                                                                               ║
+║   3️⃣  swarmmail_send(to=["coordinator"], ...) when blocked                   ║
+║       → Don't spin >5min - ASK FOR HELP                                       ║
+║                                                                               ║
+║   SKIPPING THESE = wasted time repeating solved problems                      ║
+║                                                                               ║
+╚═══════════════════════════════════════════════════════════════════════════════╝
+
 ## [IDENTITY]
 Agent: (assigned at spawn)
 Cell: {bead_id}

package/dist/tool-availability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-availability.d.ts","sourceRoot":"","sources":["../src/tool-availability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,MAAM,MAAM,QAAQ,GAChB,iBAAiB,GACjB,MAAM,GACN,UAAU,GACV,MAAM,GACN,OAAO,GACP,YAAY,GACZ,YAAY,CAAC;AAEjB,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAuRD;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAWnE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,gBAAgB,CAAC,CAO3B;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAC5C,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAChC,CA0BA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAQpD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/D;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CASxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,GAC5C,MAAM,CAWR"}
+{"version":3,"file":"tool-availability.d.ts","sourceRoot":"","sources":["../src/tool-availability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,MAAM,MAAM,QAAQ,GAChB,iBAAiB,GACjB,MAAM,GACN,UAAU,GACV,MAAM,GACN,OAAO,GACP,YAAY,GACZ,YAAY,CAAC;AAEjB,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AA6RD;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAWnE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,gBAAgB,CAAC,CAO3B;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAC5C,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAChC,CA0BA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAQpD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/D;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CASxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,GAC5C,MAAM,CAWR"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-swarm-plugin",
-  "version": "0.57.6",
+  "version": "0.59.0",
   "description": "Multi-agent swarm coordination for OpenCode with learning capabilities, beads integration, and Agent Mail",
   "type": "module",
   "main": "./dist/index.js",
@@ -70,7 +70,7 @@
     "minimatch": "^10.1.1",
     "pino": "^9.6.0",
     "pino-roll": "^1.3.0",
-    "swarm-mail": "1.10.2",
+    "swarm-mail": "1.10.3",
     "yaml": "^2.8.2",
     "zod": "4.1.8"
   },