opencode-swarm-plugin 0.26.1 → 0.27.2

package/src/index.ts

@@ -1,7 +1,7 @@
 /**
  * OpenCode Swarm Plugin
  *
- * A type-safe plugin for multi-agent coordination with beads issue tracking
+ * A type-safe plugin for multi-agent coordination with hive issue tracking
  * and Agent Mail integration. Provides structured tools for swarm operations.
  *
  * @module opencode-swarm-plugin
@@ -16,13 +16,18 @@
  *
  * @example
  * ```typescript
- * // Programmatic usage
- * import { beadsTools, agentMailTools, swarmMailTools } from "opencode-swarm-plugin"
+ * // Programmatic usage (hive is the new name, beads is deprecated)
+ * import { hiveTools, beadsTools, agentMailTools, swarmMailTools } from "opencode-swarm-plugin"
  * ```
  */
 import type { Plugin, PluginInput, Hooks } from "@opencode-ai/plugin";
 
-import { beadsTools, setBeadsWorkingDirectory } from "./beads";
+import {
+  hiveTools,
+  beadsTools,
+  setHiveWorkingDirectory,
+  setBeadsWorkingDirectory,
+} from "./hive";
 import {
   agentMailTools,
   setAgentMailProjectDirectory,
@@ -36,6 +41,8 @@ import {
 } from "./swarm-mail";
 import { structuredTools } from "./structured";
 import { swarmTools } from "./swarm";
+import { worktreeTools } from "./swarm-worktree";
+import { reviewTools } from "./swarm-review";
 import { repoCrawlTools } from "./repo-crawl";
 import { skillsTools, setSkillsProjectDirectory } from "./skills";
 import { mandateTools } from "./mandates";
@@ -53,7 +60,8 @@ import {
  * OpenCode Swarm Plugin
  *
  * Registers all swarm coordination tools:
- * - beads:* - Type-safe beads issue tracker wrappers
+ * - hive:* - Type-safe hive issue tracker wrappers (primary)
+ * - beads:* - Legacy aliases for hive tools (deprecated, use hive:* instead)
  * - agent-mail:* - Multi-agent coordination via Agent Mail MCP (legacy)
  * - swarm-mail:* - Multi-agent coordination with embedded event sourcing (recommended)
  * - structured:* - Structured output parsing and validation
@@ -70,9 +78,9 @@ export const SwarmPlugin: Plugin = async (
 ): Promise<Hooks> => {
   const { $, directory } = input;
 
-  // Set the working directory for beads commands
-  // This ensures bd runs in the project directory, not ~/.config/opencode
-  setBeadsWorkingDirectory(directory);
+  // Set the working directory for hive commands
+  // This ensures hive operations run in the project directory, not ~/.config/opencode
+  setHiveWorkingDirectory(directory);
 
   // Set the project directory for skills discovery
   // Skills are discovered from .opencode/skills/, .claude/skills/, or skills/
@@ -136,17 +144,20 @@ export const SwarmPlugin: Plugin = async (
      * Register all tools from modules
      *
      * Tools are namespaced by module:
-     * - beads:create, beads:query, beads:update, etc.
+     * - hive:create, hive:query, hive:update, etc. (primary)
+     * - beads:* - Legacy aliases (deprecated, use hive:* instead)
      * - agent-mail:init, agent-mail:send, agent-mail:reserve, etc. (legacy MCP)
      * - swarm-mail:init, swarm-mail:send, swarm-mail:reserve, etc. (embedded)
      * - repo-crawl:readme, repo-crawl:structure, etc.
      * - mandate:file, mandate:vote, mandate:query, etc.
      */
     tool: {
-      ...beadsTools,
+      ...hiveTools,
       ...swarmMailTools,
       ...structuredTools,
       ...swarmTools,
+      ...worktreeTools,
+      ...reviewTools,
       ...repoCrawlTools,
       ...skillsTools,
       ...mandateTools,
@@ -187,8 +198,8 @@ export const SwarmPlugin: Plugin = async (
      * Hook after tool execution for automatic cleanup and guardrails
      *
      * - Applies output guardrails to prevent context blowout from MCP tools
-     * - Auto-releases file reservations after swarm:complete or beads:close
-     * - Auto-syncs beads after closing
+     * - Auto-releases file reservations after swarm:complete or hive:close
+     * - Auto-syncs cells after closing
      */
     "tool.execute.after": async (input, output) => {
       const toolName = input.tool;
@@ -238,8 +249,8 @@ export const SwarmPlugin: Plugin = async (
         await releaseReservations();
       }
 
-      // Auto-sync beads after closing
-      if (toolName === "beads_close") {
+      // Auto-sync hive after closing (supports both hive_close and legacy hive_close)
+      if (toolName === "hive_close" || toolName === "hive_close") {
         // Trigger async sync without blocking - fire and forget
         void $`bd sync`.quiet().nothrow();
       }
@@ -267,14 +278,18 @@ export default SwarmPlugin;
 export * from "./schemas";
 
 /**
- * Re-export beads module
+ * Re-export hive module (primary) and beads module (deprecated aliases)
  *
  * Includes:
- * - beadsTools - All bead tool definitions
- * - Individual tool exports (beads_create, beads_query, etc.)
- * - BeadError, BeadValidationError - Error classes
+ * - hiveTools - All hive tool definitions (primary)
+ * - beadsTools - Legacy aliases for backward compatibility (deprecated)
+ * - Individual tool exports (hive_create, hive_query, etc.)
+ * - Legacy aliases (hive_create, hive_query, etc.)
+ * - HiveError, HiveValidationError (and BeadError, BeadValidationError aliases)
+ *
+ * DEPRECATED: Use hive_* tools instead of beads_* tools
  */
-export * from "./beads";
+export * from "./hive";
 
 /**
  * Re-export agent-mail module (legacy MCP-based)
@@ -391,12 +406,16 @@ export {
  *
  * This is used by `swarm tool <name>` command to dynamically execute tools.
  * Each tool has an `execute` function that takes (args, ctx) and returns a string.
+ *
+ * Note: hiveTools includes both hive_* and beads_* (legacy aliases)
  */
 export const allTools = {
-  ...beadsTools,
+  ...hiveTools,
   ...swarmMailTools,
   ...structuredTools,
   ...swarmTools,
+  ...worktreeTools,
+  ...reviewTools,
   ...repoCrawlTools,
   ...skillsTools,
   ...mandateTools,
@@ -609,3 +628,21 @@ export {
   type GuardrailResult,
   type GuardrailMetrics,
 } from "./output-guardrails";
+
+/**
+ * Re-export compaction-hook module
+ *
+ * Includes:
+ * - SWARM_COMPACTION_CONTEXT - Prompt text for swarm state preservation
+ * - createCompactionHook - Factory function for the compaction hook
+ *
+ * Usage:
+ * ```typescript
+ * import { createCompactionHook } from "opencode-swarm-plugin";
+ *
+ * const hooks = {
+ *   "experimental.session.compacting": createCompactionHook(),
+ * };
+ * ```
+ */
+export { SWARM_COMPACTION_CONTEXT, createCompactionHook } from "./compaction-hook";

package/src/learning.ts

@@ -599,7 +599,7 @@ export class InMemoryStrikeStorage implements StrikeStorage {
  *
  * Records a failure attempt and increments the strike count.
  *
- * @param beadId - Bead ID
+ * @param beadId - Cell ID
  * @param attempt - Description of what was attempted
  * @param reason - Why it failed
  * @param storage - Strike storage (defaults to in-memory)
@@ -635,7 +635,7 @@ export async function addStrike(
 /**
  * Get strike count for a bead
  *
- * @param beadId - Bead ID
+ * @param beadId - Cell ID
  * @param storage - Strike storage
  * @returns Strike count (0-3)
  */
@@ -650,7 +650,7 @@ export async function getStrikes(
 /**
  * Check if a bead has struck out (3 strikes)
  *
- * @param beadId - Bead ID
+ * @param beadId - Cell ID
  * @param storage - Strike storage
  * @returns True if bead has 3 strikes
  */
@@ -668,7 +668,7 @@ export async function isStrikedOut(
  * When a bead hits 3 strikes, this generates a prompt that forces
  * the human to question the architecture instead of attempting Fix #4.
  *
- * @param beadId - Bead ID
+ * @param beadId - Cell ID
  * @param storage - Strike storage
  * @returns Architecture review prompt
  */
@@ -711,7 +711,7 @@ This pattern suggests an **architectural problem**, not a bug.
 /**
  * Clear strikes for a bead (e.g., after successful fix)
  *
- * @param beadId - Bead ID
+ * @param beadId - Cell ID
  * @param storage - Strike storage
  */
 export async function clearStrikes(
@@ -793,7 +793,7 @@ export class ErrorAccumulator {
   /**
    * Record an error during subtask execution
    *
-   * @param beadId - Bead ID where error occurred
+   * @param beadId - Cell ID where error occurred
    * @param errorType - Category of error
    * @param message - Human-readable error message
    * @param options - Additional context (stack trace, tool name, etc.)
@@ -963,7 +963,7 @@ export class ErrorAccumulator {
 /**
  * Format memory store instruction for successful task completion
  *
- * @param beadId - Bead ID that completed
+ * @param beadId - Cell ID that completed
  * @param summary - Completion summary
  * @param filesTouched - Files modified
  * @param strategy - Decomposition strategy used (if applicable)
@@ -994,7 +994,7 @@ Files touched: ${filesTouched.join(", ") || "none"}`,
 /**
  * Format memory store instruction for architectural problems (3-strike)
  *
- * @param beadId - Bead ID that struck out
+ * @param beadId - Cell ID that struck out
  * @param failures - Array of failure attempts
  * @returns Memory store instruction object
  */
@@ -1048,7 +1048,7 @@ export function formatMemoryQueryForDecomposition(
 /**
  * Format memory validation hint when CASS history helped
  *
- * @param beadId - Bead ID that benefited from CASS
+ * @param beadId - Cell ID that benefited from CASS
  * @returns Memory validation hint
  */
 export function formatMemoryValidationHint(beadId: string): {

package/src/output-guardrails.test.ts

@@ -203,7 +203,7 @@ describe("guardrailOutput", () => {
     const longOutput = "a".repeat(50000);
 
     // Beads tools should never be truncated
-    const result = guardrailOutput("beads_create", longOutput);
+    const result = guardrailOutput("hive_create", longOutput);
 
     expect(result.truncated).toBe(false);
     expect(result.output).toBe(longOutput);
@@ -281,7 +281,7 @@ describe("guardrailOutput", () => {
 
     // Test a sample of skip tools
     const samplesToTest = [
-      "beads_create",
+      "hive_create",
       "agentmail_send",
       "swarmmail_inbox",
       "structured_validate",
@@ -361,8 +361,8 @@ describe("DEFAULT_GUARDRAIL_CONFIG", () => {
 
     // Sample of tools that should be in skipTools
     const expectedSkips = [
-      "beads_create",
-      "beads_sync",
+      "hive_create",
+      "hive_sync",
       "agentmail_init",
       "swarmmail_send",
       "structured_parse_evaluation",

package/src/output-guardrails.ts

@@ -109,14 +109,14 @@ export const DEFAULT_GUARDRAIL_CONFIG: GuardrailConfig = {
 
   skipTools: [
     // Beads tools - always return full output
-    "beads_create",
-    "beads_create_epic",
-    "beads_query",
-    "beads_update",
-    "beads_close",
-    "beads_start",
-    "beads_ready",
-    "beads_sync",
+    "hive_create",
+    "hive_create_epic",
+    "hive_query",
+    "hive_update",
+    "hive_close",
+    "hive_start",
+    "hive_ready",
+    "hive_sync",
 
     // Agent Mail tools - always return full output
     "agentmail_init",
@@ -142,7 +142,7 @@ export const DEFAULT_GUARDRAIL_CONFIG: GuardrailConfig = {
     "structured_validate",
     "structured_parse_evaluation",
     "structured_parse_decomposition",
-    "structured_parse_bead_tree",
+    "structured_parse_cell_tree",
 
     // Swarm orchestration tools - always return full output
     "swarm_select_strategy",

package/src/planning-guardrails.test.ts

@@ -9,7 +9,7 @@ describe("planning-guardrails", () => {
     });
 
     it("returns false for other tools", () => {
-      expect(shouldAnalyzeTool("beads_create")).toBe(false);
+      expect(shouldAnalyzeTool("hive_create")).toBe(false);
       expect(shouldAnalyzeTool("swarm_decompose")).toBe(false);
       expect(shouldAnalyzeTool("read")).toBe(false);
     });

package/src/planning-guardrails.ts

@@ -122,7 +122,7 @@ export function analyzeTodoWrite(args: { todos?: unknown[] }): TodoWriteAnalysis
       warning: `⚠️  This looks like a multi-file implementation plan (${fileModificationCount}/${todos.length} items are file modifications).
 
 Consider using swarm instead:
-  swarm_decompose → beads_create_epic → parallel task spawns
+  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.