opencode-swarm-plugin 0.36.0 → 0.37.0

package/dist/planning-guardrails.d.ts

@@ -40,4 +40,125 @@ export declare function analyzeTodoWrite(args: {
  * @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";
+    /** 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).
+ *
+ * @param ctx - Coordinator context to set
+ */
+export declare function setCoordinatorContext(ctx: Partial<CoordinatorContext>): void;
+/**
+ * Get current coordinator context
+ *
+ * @returns Current coordinator context state
+ */
+export declare function getCoordinatorContext(): CoordinatorContext;
+/**
+ * Clear coordinator context
+ *
+ * Called when swarm coordination ends (e.g., epic closed or session ends).
+ */
+export declare function clearCoordinatorContext(): 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)
+ *
+ * @returns Whether we're currently in coordinator mode
+ */
+export declare function isInCoordinatorContext(): boolean;
+export {};
 //# sourceMappingURL=planning-guardrails.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"planning-guardrails.d.ts","sourceRoot":"","sources":["../src/planning-guardrails.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyCH;;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"}
+{"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,CAAC;IAExB,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,CAwG3B;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;AAOD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAM5E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAiBhD"}

package/dist/plugin.d.ts

@@ -1,22 +1,22 @@
 /**
  * OpenCode Plugin Entry Point
  *
- * CRITICAL: Only export the plugin function from this file.
+ * CRITICAL: Only export the plugin function as DEFAULT from this file.
  *
  * OpenCode's plugin loader calls ALL exports as functions during initialization.
- * Exporting classes, constants, or non-function values will cause the plugin
- * to fail to load with cryptic errors.
+ * 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 export the plugin function
+ * // ✅ CORRECT - only default export
  * export default SwarmPlugin;
  *
- * // ❌ WRONG - will break plugin loading
- * export const VERSION = "1.0.0";
- * export class Helper {}
+ * // ❌ WRONG - causes double registration
+ * export { SwarmPlugin };
+ * export default SwarmPlugin;
  */
-import { SwarmPlugin } from "./index";
-export { SwarmPlugin };
+import SwarmPlugin from "./index";
+export default SwarmPlugin;
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"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"}