opencode-swarm-plugin 0.44.0 → 0.44.1

package/src/planning-guardrails.ts

@@ -1,438 +0,0 @@
-/**
- * Planning Guardrails
- *
- * Detects when agents are about to make planning mistakes and warns them.
- * Non-blocking - just emits warnings to help agents self-correct.
- *
- * @module planning-guardrails
- */
-
-import { captureCoordinatorEvent } from "./eval-capture.js";
-
-/**
- * Patterns that suggest file modification work
- * These indicate the todo is about implementation, not tracking
- */
-const 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,
-];
-
-/**
- * Patterns that suggest this is tracking/coordination work (OK for todowrite)
- */
-const 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,
-];
-
-/**
- * Result of analyzing todowrite args
- */
-export interface TodoWriteAnalysis {
-  /** Whether this looks like parallel work that should use swarm */
-  looksLikeParallelWork: boolean;
-
-  /** Number of todos that look like file modifications */
-  fileModificationCount: number;
-
-  /** Total number of todos */
-  totalCount: number;
-
-  /** Warning message if applicable */
-  warning?: string;
-}
-
-/**
- * Analyze todowrite args to detect potential planning mistakes
- *
- * Triggers warning when:
- * - 6+ todos created in one call
- * - Most todos match file modification patterns
- * - Few todos match tracking patterns
- *
- * @param args - The todowrite tool arguments
- * @returns Analysis result with optional warning
- */
-export function analyzeTodoWrite(args: { todos?: unknown[] }): TodoWriteAnalysis {
-  const todos = args.todos;
-
-  // Not enough todos to analyze
-  if (!todos || !Array.isArray(todos) || todos.length < 6) {
-    return {
-      looksLikeParallelWork: false,
-      fileModificationCount: 0,
-      totalCount: todos?.length ?? 0,
-    };
-  }
-
-  // Count todos that look like file modifications
-  let fileModificationCount = 0;
-
-  for (const todo of todos) {
-    if (typeof todo !== "object" || todo === null) continue;
-
-    const content = (todo as { content?: string }).content ?? "";
-
-    // Check if it matches file modification patterns
-    const isFileModification = FILE_MODIFICATION_PATTERNS.some((pattern) =>
-      pattern.test(content)
-    );
-
-    // Check if it matches tracking patterns
-    const isTracking = TRACKING_PATTERNS.some((pattern) =>
-      pattern.test(content)
-    );
-
-    if (isFileModification && !isTracking) {
-      fileModificationCount++;
-    }
-    // trackingCount not currently used but kept for future ratio analysis
-  }
-
-  // Trigger warning if most todos look like file modifications
-  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,
-  };
-}
-
-/**
- * Check if a tool call should trigger planning guardrails
- *
- * @param toolName - Name of the tool being called
- * @returns Whether this tool should be analyzed
- */
-export function shouldAnalyzeTool(toolName: string): boolean {
-  return toolName === "todowrite" || toolName === "TodoWrite";
-}
-
-/**
- * Violation patterns for coordinator behavior detection
- *
- * These patterns identify when a coordinator is performing work
- * that should be delegated to worker agents.
- *
- * @example
- * ```ts
- * // Bad: Coordinator editing files
- * if (VIOLATION_PATTERNS.FILE_MODIFICATION_TOOLS.includes("edit")) { ... }
- *
- * // Good: Worker editing files
- * // (no violation when agentContext === "worker")
- * ```
- */
-export const VIOLATION_PATTERNS = {
-  /**
-   * Tool names that modify files
-   *
-   * Coordinators should NEVER call these tools directly.
-   * Workers reserve files and make modifications.
-   */
-  FILE_MODIFICATION_TOOLS: ["edit", "write"],
-
-  /**
-   * Tool names for file reservations
-   *
-   * Coordinators don't reserve files - workers do this
-   * before editing to prevent conflicts.
-   */
-  RESERVATION_TOOLS: ["swarmmail_reserve", "agentmail_reserve"],
-
-  /**
-   * Regex patterns that indicate test execution in bash commands
-   *
-   * Coordinators review test results, workers run tests.
-   * Matches common test runners and test file patterns.
-   */
-  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,
-  ],
-} as const;
-
-/**
- * Result of violation detection
- */
-export interface ViolationDetectionResult {
-  /** Whether a violation was detected */
-  isViolation: boolean;
-
-  /** Type of violation if detected */
-  violationType?:
-    | "coordinator_edited_file"
-    | "coordinator_ran_tests"
-    | "coordinator_reserved_files"
-    | "no_worker_spawned";
-
-  /** Human-readable message */
-  message?: string;
-
-  /** Payload data for the violation */
-  payload?: Record<string, unknown>;
-}
-
-/**
- * Detect coordinator violations in real-time
- *
- * Checks for patterns that indicate a coordinator is doing work
- * that should be delegated to workers:
- * 1. Edit/Write tool calls (coordinators plan, workers implement)
- * 2. Test execution (workers verify, coordinators review)
- * 3. File reservations (workers reserve before editing)
- * 4. No worker spawned after decomposition (coordinators must delegate)
- *
- * When a violation is detected, captures it via captureCoordinatorEvent().
- *
- * @param params - Detection parameters
- * @returns Violation detection result
- */
-export function detectCoordinatorViolation(params: {
-  sessionId: string;
-  epicId: string;
-  toolName: string;
-  toolArgs: Record<string, unknown>;
-  agentContext: "coordinator" | "worker";
-  checkNoSpawn?: boolean;
-}): ViolationDetectionResult {
-  const { sessionId, epicId, toolName, toolArgs, agentContext, checkNoSpawn = false } = params;
-
-  // Only check coordinator violations
-  if (agentContext !== "coordinator") {
-    return { isViolation: false };
-  }
-
-  // Check for file modification violation
-  if (VIOLATION_PATTERNS.FILE_MODIFICATION_TOOLS.includes(toolName as any)) {
-    const file = (toolArgs.filePath as string) || "";
-    const payload = { tool: toolName, file };
-
-    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,
-    };
-  }
-
-  // Check for test execution violation
-  if (toolName === "bash") {
-    const command = (toolArgs.command as string) || "";
-    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,
-      };
-    }
-  }
-
-  // Check for file reservation violation
-  if (VIOLATION_PATTERNS.RESERVATION_TOOLS.includes(toolName as any)) {
-    const paths = (toolArgs.paths as string[]) || [];
-    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,
-    };
-  }
-
-  // Check for no worker spawned after decomposition
-  if (toolName === "hive_create_epic" && checkNoSpawn) {
-    const epicTitle = (toolArgs.epic_title as string) || "";
-    const subtasks = (toolArgs.subtasks as unknown[]) || [];
-    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,
-    };
-  }
-
-  return { isViolation: false };
-}
-
-/**
- * Coordinator context state
- * 
- * Tracks whether the current session is acting as a swarm coordinator.
- * Set when an epic is created or when swarm tools are used.
- */
-interface CoordinatorContext {
-  /** Whether we're in coordinator mode */
-  isCoordinator: boolean;
-  /** Active epic ID if any */
-  epicId?: string;
-  /** Session ID for event capture */
-  sessionId?: string;
-  /** When coordinator mode was activated */
-  activatedAt?: number;
-}
-
-/** Global coordinator context state */
-let coordinatorContext: CoordinatorContext = {
-  isCoordinator: false,
-};
-
-/**
- * Set coordinator context
- * 
- * Called when swarm coordination begins (e.g., after hive_create_epic or swarm_decompose).
- * 
- * @param ctx - Coordinator context to set
- */
-export function setCoordinatorContext(ctx: Partial<CoordinatorContext>): void {
-  coordinatorContext = {
-    ...coordinatorContext,
-    ...ctx,
-    activatedAt: ctx.isCoordinator ? Date.now() : coordinatorContext.activatedAt,
-  };
-}
-
-/**
- * Get current coordinator context
- * 
- * @returns Current coordinator context state
- */
-export function getCoordinatorContext(): CoordinatorContext {
-  return { ...coordinatorContext };
-}
-
-/**
- * Clear coordinator context
- * 
- * Called when swarm coordination ends (e.g., epic closed or session ends).
- */
-export function clearCoordinatorContext(): void {
-  coordinatorContext = {
-    isCoordinator: false,
-  };
-}
-
-/**
- * Check if we're in coordinator context
- * 
- * Returns true if:
- * 1. Coordinator context was explicitly set
- * 2. Context was set within the last 4 hours (session timeout)
- * 
- * @returns Whether we're currently in coordinator mode
- */
-export function isInCoordinatorContext(): boolean {
-  if (!coordinatorContext.isCoordinator) {
-    return false;
-  }
-  
-  // Check for session timeout (4 hours)
-  const COORDINATOR_TIMEOUT_MS = 4 * 60 * 60 * 1000;
-  if (coordinatorContext.activatedAt) {
-    const elapsed = Date.now() - coordinatorContext.activatedAt;
-    if (elapsed > COORDINATOR_TIMEOUT_MS) {
-      // Session timed out, clear context
-      clearCoordinatorContext();
-      return false;
-    }
-  }
-  
-  return true;
-}

package/src/plugin.ts

@@ -1,23 +0,0 @@
-/**
- * OpenCode Plugin Entry Point
- *
- * CRITICAL: Only export the plugin function as DEFAULT from this file.
- *
- * OpenCode's plugin loader calls ALL exports as functions during initialization.
- * If you export both named AND default pointing to the same function, the plugin
- * gets registered TWICE, causing hooks to fire multiple times.
- *
- * If you need to export utilities for external use, add them to src/index.ts instead.
- *
- * @example
- * // ✅ CORRECT - only default export
- * export default SwarmPlugin;
- *
- * // ❌ WRONG - causes double registration
- * export { SwarmPlugin };
- * export default SwarmPlugin;
- */
-import SwarmPlugin from "./index";
-
-// Only default export - no named exports!
-export default SwarmPlugin;

package/src/post-compaction-tracker.test.ts

@@ -1,251 +0,0 @@
-/**
- * Post-Compaction Tool Call Tracker Tests
- *
- * TDD: RED → GREEN → REFACTOR
- *
- * Tests tracking of tool calls after compaction resumption.
- * Emits resumption_started on first tool call, then tool_call_tracked for each call (max 20).
- * Detects coordinator violations: Edit, Write, swarmmail_reserve are forbidden.
- */
-import { describe, test, expect, beforeEach, mock } from "bun:test";
-import {
-  createPostCompactionTracker,
-  type PostCompactionTracker,
-  type ToolCallEvent,
-} from "./post-compaction-tracker";
-
-describe("PostCompactionTracker - TDD", () => {
-  let tracker: PostCompactionTracker;
-  let mockCapture: ReturnType<typeof mock>;
-
-  beforeEach(() => {
-    mockCapture = mock((event: any) => {});
-    tracker = createPostCompactionTracker({
-      sessionId: "test-session",
-      epicId: "mjkwehsqnbm",
-      onEvent: mockCapture,
-    });
-  });
-
-  // ============================================================================
-  // RED: Test resumption_started event
-  // ============================================================================
-
-  test("emits resumption_started on first tool call", () => {
-    const toolCall: ToolCallEvent = {
-      tool: "read",
-      args: { filePath: "/test/file.ts" },
-      timestamp: Date.now(),
-    };
-
-    tracker.trackToolCall(toolCall);
-
-    expect(mockCapture).toHaveBeenCalledTimes(2); // resumption_started + tool_call_tracked
-    const firstCall = mockCapture.mock.calls[0][0];
-    expect(firstCall.compaction_type).toBe("resumption_started");
-    expect(firstCall.payload.session_id).toBe("test-session");
-    expect(firstCall.payload.epic_id).toBe("mjkwehsqnbm");
-  });
-
-  test("resumption_started only emitted once", () => {
-    tracker.trackToolCall({
-      tool: "read",
-      args: {},
-      timestamp: Date.now(),
-    });
-    tracker.trackToolCall({
-      tool: "glob",
-      args: {},
-      timestamp: Date.now(),
-    });
-
-    // First call: resumption_started + tool_call_tracked
-    // Second call: tool_call_tracked only
-    expect(mockCapture).toHaveBeenCalledTimes(3);
-
-    const calls = mockCapture.mock.calls;
-    expect(calls[0][0].compaction_type).toBe("resumption_started");
-    expect(calls[1][0].compaction_type).toBe("tool_call_tracked");
-    expect(calls[2][0].compaction_type).toBe("tool_call_tracked");
-  });
-
-  // ============================================================================
-  // RED: Test tool_call_tracked event
-  // ============================================================================
-
-  test("emits tool_call_tracked for each of first 20 calls", () => {
-    for (let i = 0; i < 20; i++) {
-      tracker.trackToolCall({
-        tool: `tool-${i}`,
-        args: {},
-        timestamp: Date.now(),
-      });
-    }
-
-    // First call: resumption_started + tool_call_tracked = 2
-    // Next 19 calls: tool_call_tracked only = 19
-    // Total: 21 events (1 resumption_started + 20 tool_call_tracked)
-    expect(mockCapture).toHaveBeenCalledTimes(21);
-
-    const trackedEvents = mockCapture.mock.calls.filter(
-      (call: any) => call[0].compaction_type === "tool_call_tracked",
-    );
-    expect(trackedEvents).toHaveLength(20);
-  });
-
-  test("tool_call_tracked includes tool name and args", () => {
-    tracker.trackToolCall({
-      tool: "edit",
-      args: { filePath: "/test.ts", oldString: "foo", newString: "bar" },
-      timestamp: Date.now(),
-    });
-
-    const trackedEvent = mockCapture.mock.calls.find(
-      (call: any) => call[0].compaction_type === "tool_call_tracked",
-    )?.[0];
-
-    expect(trackedEvent).toBeDefined();
-    expect(trackedEvent.payload.tool).toBe("edit");
-    expect(trackedEvent.payload.args.filePath).toBe("/test.ts");
-    expect(trackedEvent.payload.call_number).toBe(1);
-  });
-
-  // ============================================================================
-  // RED: Test coordinator violation detection
-  // ============================================================================
-
-  test("detects Edit as coordinator violation", () => {
-    tracker.trackToolCall({
-      tool: "edit",
-      args: { filePath: "/test.ts", oldString: "a", newString: "b" },
-      timestamp: Date.now(),
-    });
-
-    const trackedEvent = mockCapture.mock.calls.find(
-      (call: any) => call[0].compaction_type === "tool_call_tracked",
-    )?.[0];
-
-    expect(trackedEvent.payload.is_coordinator_violation).toBe(true);
-    expect(trackedEvent.payload.violation_reason).toBe(
-      "Coordinators NEVER edit files - spawn worker instead",
-    );
-  });
-
-  test("detects Write as coordinator violation", () => {
-    tracker.trackToolCall({
-      tool: "write",
-      args: { filePath: "/new.ts", content: "export {}" },
-      timestamp: Date.now(),
-    });
-
-    const trackedEvent = mockCapture.mock.calls.find(
-      (call: any) => call[0].compaction_type === "tool_call_tracked",
-    )?.[0];
-
-    expect(trackedEvent.payload.is_coordinator_violation).toBe(true);
-    expect(trackedEvent.payload.violation_reason).toBe(
-      "Coordinators NEVER write files - spawn worker instead",
-    );
-  });
-
-  test("detects swarmmail_reserve as coordinator violation", () => {
-    tracker.trackToolCall({
-      tool: "swarmmail_reserve",
-      args: { paths: ["/src/**"], reason: "test" },
-      timestamp: Date.now(),
-    });
-
-    const trackedEvent = mockCapture.mock.calls.find(
-      (call: any) => call[0].compaction_type === "tool_call_tracked",
-    )?.[0];
-
-    expect(trackedEvent.payload.is_coordinator_violation).toBe(true);
-    expect(trackedEvent.payload.violation_reason).toBe(
-      "Coordinators NEVER reserve files - workers reserve files",
-    );
-  });
-
-  test("does not flag Read as violation", () => {
-    tracker.trackToolCall({
-      tool: "read",
-      args: { filePath: "/test.ts" },
-      timestamp: Date.now(),
-    });
-
-    const trackedEvent = mockCapture.mock.calls.find(
-      (call: any) => call[0].compaction_type === "tool_call_tracked",
-    )?.[0];
-
-    expect(trackedEvent.payload.is_coordinator_violation).toBe(false);
-    expect(trackedEvent.payload.violation_reason).toBeUndefined();
-  });
-
-  test("does not flag swarm_spawn_subtask as violation", () => {
-    tracker.trackToolCall({
-      tool: "swarm_spawn_subtask",
-      args: { bead_id: "bd-123", subtask_title: "Test" },
-      timestamp: Date.now(),
-    });
-
-    const trackedEvent = mockCapture.mock.calls.find(
-      (call: any) => call[0].compaction_type === "tool_call_tracked",
-    )?.[0];
-
-    expect(trackedEvent.payload.is_coordinator_violation).toBe(false);
-  });
-
-  // ============================================================================
-  // RED: Test tracking stops after 20 calls
-  // ============================================================================
-
-  test("stops tracking after 20 calls", () => {
-    for (let i = 0; i < 25; i++) {
-      tracker.trackToolCall({
-        tool: `tool-${i}`,
-        args: {},
-        timestamp: Date.now(),
-      });
-    }
-
-    // Should only track first 20: 1 resumption_started + 20 tool_call_tracked
-    expect(mockCapture).toHaveBeenCalledTimes(21);
-  });
-
-  test("returns tracking status", () => {
-    expect(tracker.isTracking()).toBe(true);
-
-    for (let i = 0; i < 20; i++) {
-      tracker.trackToolCall({
-        tool: `tool-${i}`,
-        args: {},
-        timestamp: Date.now(),
-      });
-    }
-
-    expect(tracker.isTracking()).toBe(false);
-  });
-
-  // ============================================================================
-  // RED: Test configurable limit
-  // ============================================================================
-
-  test("respects custom call limit", () => {
-    const customTracker = createPostCompactionTracker({
-      sessionId: "test",
-      epicId: "test",
-      onEvent: mockCapture,
-      maxCalls: 5,
-    });
-
-    for (let i = 0; i < 10; i++) {
-      customTracker.trackToolCall({
-        tool: `tool-${i}`,
-        args: {},
-        timestamp: Date.now(),
-      });
-    }
-
-    // 1 resumption_started + 5 tool_call_tracked
-    expect(mockCapture).toHaveBeenCalledTimes(6);
-  });
-});