opencode-swarm-plugin 0.56.0 → 0.57.0

package/claude-plugin/dist/planning-guardrails.d.ts

@@ -0,0 +1,183 @@
+/**
+ * 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
+ */
+/**
+ * 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 declare function analyzeTodoWrite(args: {
+    todos?: unknown[];
+}): TodoWriteAnalysis;
+/**
+ * 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 declare function shouldAnalyzeTool(toolName: string): boolean;
+/**
+ * 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 declare const VIOLATION_PATTERNS: {
+    /**
+     * Tool names that modify files
+     *
+     * Coordinators should NEVER call these tools directly.
+     * Workers reserve files and make modifications.
+     */
+    readonly FILE_MODIFICATION_TOOLS: readonly ["edit", "write"];
+    /**
+     * Tool names for file reservations
+     *
+     * Coordinators don't reserve files - workers do this
+     * before editing to prevent conflicts.
+     */
+    readonly RESERVATION_TOOLS: readonly ["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.
+     */
+    readonly TEST_EXECUTION_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];
+};
+/**
+ * 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" | "worker_completed_without_review";
+    /** 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 declare function detectCoordinatorViolation(params: {
+    sessionId: string;
+    epicId: string;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+    agentContext: "coordinator" | "worker";
+    checkNoSpawn?: boolean;
+}): ViolationDetectionResult;
+/**
+ * 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;
+}
+/**
+ * Set coordinator context
+ *
+ * Called when swarm coordination begins (e.g., after hive_create_epic or swarm_decompose).
+ * If sessionId is provided, stores context scoped to that session.
+ * Otherwise updates global context (backward compat).
+ *
+ * @param ctx - Coordinator context to set
+ */
+export declare function setCoordinatorContext(ctx: Partial<CoordinatorContext>): void;
+/**
+ * Get current coordinator context
+ *
+ * If sessionId provided, returns session-scoped context.
+ * Otherwise returns global context (backward compat).
+ *
+ * @param sessionId - Optional session ID to get specific session context
+ * @returns Current coordinator context state
+ */
+export declare function getCoordinatorContext(sessionId?: string): CoordinatorContext;
+/**
+ * Clear coordinator context
+ *
+ * If sessionId provided, clears only that session.
+ * Otherwise clears global context (backward compat).
+ *
+ * @param sessionId - Optional session ID to clear specific session
+ */
+export declare function clearCoordinatorContext(sessionId?: string): void;
+/**
+ * Clear ALL coordinator contexts (global + all sessions)
+ *
+ * Use in tests or cleanup scenarios where you need a complete reset.
+ */
+export declare function clearAllCoordinatorContexts(): void;
+/**
+ * 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)
+ *
+ * If sessionId provided, checks session-scoped context.
+ * Otherwise checks global context (backward compat).
+ *
+ * @param sessionId - Optional session ID to check specific session
+ * @returns Whether we're currently in coordinator mode
+ */
+export declare function isInCoordinatorContext(sessionId?: string): boolean;
+export {};
+//# sourceMappingURL=planning-guardrails.d.ts.map

package/claude-plugin/dist/planning-guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-guardrails.d.ts","sourceRoot":"","sources":["../src/planning-guardrails.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2CH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,qBAAqB,EAAE,OAAO,CAAC;IAE/B,wDAAwD;IACxD,qBAAqB,EAAE,MAAM,CAAC;IAE9B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IAEnB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,GAAG,iBAAiB,CA8D/E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB;IAC7B;;;;;OAKG;;IAGH;;;;;OAKG;;IAGH;;;;;OAKG;;CAcK,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uCAAuC;IACvC,WAAW,EAAE,OAAO,CAAC;IAErB,oCAAoC;IACpC,aAAa,CAAC,EACV,yBAAyB,GACzB,uBAAuB,GACvB,4BAA4B,GAC5B,mBAAmB,GACnB,iCAAiC,CAAC;IAEtC,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,EAAE,aAAa,GAAG,QAAQ,CAAC;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,wBAAwB,CA6H3B;AAED;;;;;GAKG;AACH,UAAU,kBAAkB;IAC1B,wCAAwC;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAeD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAmB5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAK5E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAQhE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAKlD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAyBlE"}

package/claude-plugin/dist/plugin.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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";
+export default SwarmPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/claude-plugin/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,WAAW,MAAM,SAAS,CAAC;AAGlC,eAAe,WAAW,CAAC"}