opencode-swarm-plugin 0.59.0 → 0.59.5

package/dist/swarm-verify.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Swarm Verify Module - Verification gate for worker completions
+ *
+ * Handles verification logic for swarm workers:
+ * - Typecheck verification (tsc --noEmit)
+ * - Test verification for touched files
+ * - Verification gate orchestration
+ *
+ * Implements the Gate Function (IDENTIFY → RUN → READ → VERIFY → CLAIM)
+ * from the superpowers pattern.
+ *
+ * @module swarm-verify
+ */
+/**
+ * Verification Gate result - tracks each verification step
+ *
+ * Based on the Gate Function from superpowers:
+ * 1. IDENTIFY: What command proves this claim?
+ * 2. RUN: Execute the FULL command (fresh, complete)
+ * 3. READ: Full output, check exit code, count failures
+ * 4. VERIFY: Does output confirm the claim?
+ * 5. ONLY THEN: Make the claim
+ */
+export interface VerificationStep {
+    name: string;
+    command: string;
+    passed: boolean;
+    exitCode: number;
+    output?: string;
+    error?: string;
+    skipped?: boolean;
+    skipReason?: string;
+}
+export interface VerificationGateResult {
+    passed: boolean;
+    steps: VerificationStep[];
+    summary: string;
+    blockers: string[];
+}
+/**
+ * Run typecheck verification
+ *
+ * Attempts to run TypeScript type checking on the project.
+ * Falls back gracefully if tsc is not available.
+ */
+export declare function runTypecheckVerification(): Promise<VerificationStep>;
+/**
+ * Run test verification for specific files
+ *
+ * Attempts to find and run tests related to the touched files.
+ * Uses common test patterns (*.test.ts, *.spec.ts, __tests__/).
+ */
+export declare function runTestVerification(filesTouched: string[]): Promise<VerificationStep>;
+/**
+ * Run the full Verification Gate
+ *
+ * Implements the Gate Function (IDENTIFY → RUN → READ → VERIFY → CLAIM):
+ * 1. Typecheck
+ * 2. Tests for touched files
+ *
+ * NOTE: Bug scanning was removed in v0.31 - it was slowing down completion
+ * without providing proportional value.
+ *
+ * All steps must pass (or be skipped with valid reason) to proceed.
+ */
+export declare function runVerificationGate(filesTouched: string[], _skipUbs?: boolean): Promise<VerificationGateResult>;
+/**
+ * Run verification gate for a set of files
+ *
+ * Delegates to the verification worker to run typecheck and tests.
+ * Returns structured verification results.
+ */
+export declare const swarm_verify: {
+    description: string;
+    args: {
+        files_touched: import("zod").ZodArray<import("zod").ZodString>;
+        skip_verification: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    };
+    execute(args: {
+        files_touched: string[];
+        skip_verification?: boolean | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Verification tools for plugin registration
+ */
+export declare const verificationTools: {
+    swarm_verify: {
+        description: string;
+        args: {
+            files_touched: import("zod").ZodArray<import("zod").ZodString>;
+            skip_verification: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        };
+        execute(args: {
+            files_touched: string[];
+            skip_verification?: boolean | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+};
+//# sourceMappingURL=swarm-verify.d.ts.map

package/dist/swarm-verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-verify.d.ts","sourceRoot":"","sources":["../src/swarm-verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD;;;;;GAKG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAiC1E;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAoE3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EAAE,EACtB,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAsCjC;AAMD;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;CAsFvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAE7B,CAAC"}

package/dist/swarm.d.ts

@@ -16,11 +16,23 @@ export * from "./swarm-prompts";
 export * from "./swarm-orchestrate";
 export * from "./swarm-research";
 export * from "./swarm-adversarial-review";
+export * from "./swarm-verify";
 /**
  * Combined swarm tools for plugin registration.
- * Includes all tools from strategy, decompose, prompt, orchestrate, research, and adversarial-review modules.
+ * Includes all tools from strategy, decompose, prompt, orchestrate, research, adversarial-review, and verification modules.
  */
 export declare const swarmTools: {
+    swarm_verify: {
+        description: string;
+        args: {
+            files_touched: import("zod").ZodArray<import("zod").ZodString>;
+            skip_verification: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        };
+        execute(args: {
+            files_touched: string[];
+            skip_verification?: boolean | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
     swarm_adversarial_review: {
         description: string;
         args: {

package/dist/swarm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../src/swarm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAU3C;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOtB,CAAC"}
+{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../src/swarm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAW/B;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQtB,CAAC"}

package/dist/utils/adapter-cache.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Generic adapter cache for project-scoped singletons
+ *
+ * Caches expensive adapters (database connections, indexers, etc.)
+ * keyed by project path. Ensures one instance per project.
+ *
+ * @example
+ * ```ts
+ * const memoryCache = new AdapterCache<MemoryAdapter>();
+ * const adapter = await memoryCache.get(projectPath, async (path) => {
+ *   const db = await getDatabase(path);
+ *   return createMemoryAdapter(db);
+ * });
+ * ```
+ */
+export declare class AdapterCache<T> {
+    private cached;
+    private cachedPath;
+    /**
+     * Get cached adapter or create new one
+     *
+     * @param projectPath - Project path to scope the adapter to
+     * @param factory - Async factory function to create the adapter
+     * @returns Cached or newly created adapter instance
+     */
+    get(projectPath: string, factory: (path: string) => Promise<T>): Promise<T>;
+    /**
+     * Clear the cache (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Get the currently cached project path
+     */
+    getCachedPath(): string | null;
+}
+//# sourceMappingURL=adapter-cache.d.ts.map

package/dist/utils/adapter-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-cache.d.ts","sourceRoot":"","sources":["../../src/utils/adapter-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAY,CAAC,CAAC;IAC1B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAuB;IAEzC;;;;;;OAMG;IACG,GAAG,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACnC,OAAO,CAAC,CAAC,CAAC;IAUb;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG9B"}

package/dist/utils/event-utils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Event Utilities - Safe event emission for swarm-mail
+ *
+ * Provides a standardized way to emit events with error handling across all tools.
+ * Events are emitted to the swarm-mail event store for observability and learning.
+ *
+ * Pattern extracted from 21+ identical try-catch blocks across tool files.
+ */
+/**
+ * Safely emit an event to the swarm-mail event store.
+ *
+ * Wraps event creation and emission in a try-catch to prevent tool failures
+ * from event system issues. Logs warnings on failure but continues execution.
+ *
+ * @param eventType - The type of event to emit (e.g., "cell_created", "memory_stored")
+ * @param data - Event data (project_key is added automatically if not present)
+ * @param toolName - Name of the calling tool for logging (e.g., "hive_create", "hivemind_store")
+ * @param projectPath - Project path for event storage (defaults to process.cwd())
+ *
+ * @example
+ * ```typescript
+ * await safeEmitEvent(
+ *   "cell_created",
+ *   { cell_id: cell.id, title: "Fix bug" },
+ *   "hive_create",
+ *   "/path/to/project"
+ * );
+ * ```
+ */
+export declare function safeEmitEvent(eventType: string, data: Record<string, unknown>, toolName: string, projectPath?: string): Promise<void>;
+//# sourceMappingURL=event-utils.d.ts.map

package/dist/utils/event-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-utils.d.ts","sourceRoot":"","sources":["../../src/utils/event-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,aAAa,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-swarm-plugin",
-  "version": "0.59.0",
+  "version": "0.59.5",
   "description": "Multi-agent swarm coordination for OpenCode with learning capabilities, beads integration, and Agent Mail",
   "type": "module",
   "main": "./dist/index.js",