opencode-swarm-plugin 0.51.0 → 0.53.0

package/examples/plugin-wrapper-template.ts

@@ -349,43 +349,193 @@ function logCompaction(
 }
 
 /**
- * Capture compaction event for evals via CLI
+ * Get date-stamped log file path
+ * Format: ~/.config/swarm-tools/logs/{type}-YYYY-MM-DD.log
+ */
+function getDateStampedLogPath(type: "tools" | "swarmmail" | "errors"): string {
+  const today = new Date().toISOString().split("T")[0]; // YYYY-MM-DD
+  return join(LOG_DIR, `${type}-${today}.log`);
+}
+
+/**
+ * Rotate old log files (delete files older than 7 days)
+ * 
+ * Runs silently - never breaks the plugin if rotation fails.
+ */
+function rotateLogFiles(): void {
+  try {
+    ensureLogDir();
+    const { readdirSync, unlinkSync, statSync } = require("node:fs");
+    const files = readdirSync(LOG_DIR);
+    const now = Date.now();
+    const sevenDaysMs = 7 * 24 * 60 * 60 * 1000;
+
+    for (const file of files) {
+      // Only rotate date-stamped files (tools-*, swarmmail-*, errors-*)
+      if (!/^(tools|swarmmail|errors)-\d{4}-\d{2}-\d{2}\.log$/.test(file)) {
+        continue;
+      }
+
+      const filePath = join(LOG_DIR, file);
+      const stats = statSync(filePath);
+      const age = now - stats.mtimeMs;
+
+      if (age > sevenDaysMs) {
+        unlinkSync(filePath);
+      }
+    }
+  } catch {
+    // Silently fail - rotation failures shouldn't break the plugin
+  }
+}
+
+/**
+ * Log a tool invocation to date-stamped file
+ * 
+ * @param toolName - Tool name (e.g., "hive_create", "swarm_status")
+ * @param args - Tool arguments
+ * @param result - Tool result (optional, for successful calls)
+ * @param error - Error message (optional, for failed calls)
+ */
+function logTool(
+  toolName: string,
+  args: Record<string, unknown>,
+  result?: string,
+  error?: string,
+): void {
+  try {
+    ensureLogDir();
+    rotateLogFiles(); // Rotate on every log call (cheap operation)
+
+    const logPath = getDateStampedLogPath("tools");
+    const entry = JSON.stringify({
+      time: new Date().toISOString(),
+      level: error ? "error" : "info",
+      msg: `tool_call: ${toolName}`,
+      tool: toolName,
+      args,
+      ...(result && { result }),
+      ...(error && { error }),
+    });
+
+    appendFileSync(logPath, entry + "\n");
+  } catch {
+    // Silently fail - logging should never break the plugin
+  }
+}
+
+/**
+ * Log a Swarm Mail event to date-stamped file
  * 
- * Shells out to `swarm capture` command to avoid import issues.
- * The CLI handles all the logic - plugin wrapper stays dumb.
+ * @param event - Event type (e.g., "message_sent", "inbox_fetched")
+ * @param data - Event data
+ */
+function logSwarmMail(
+  event: string,
+  data: Record<string, unknown>,
+): void {
+  try {
+    ensureLogDir();
+    rotateLogFiles();
+
+    const logPath = getDateStampedLogPath("swarmmail");
+    const entry = JSON.stringify({
+      time: new Date().toISOString(),
+      level: "info",
+      msg: event,
+      ...data,
+    });
+
+    appendFileSync(logPath, entry + "\n");
+  } catch {
+    // Silently fail
+  }
+}
+
+/**
+ * Log an error to date-stamped file
+ * 
+ * @param error - Error message
+ * @param data - Additional error context
+ */
+function logError(
+  error: string,
+  data?: Record<string, unknown>,
+): void {
+  try {
+    ensureLogDir();
+    rotateLogFiles();
+
+    const logPath = getDateStampedLogPath("errors");
+    const entry = JSON.stringify({
+      time: new Date().toISOString(),
+      level: "error",
+      msg: error,
+      ...data,
+    });
+
+    appendFileSync(logPath, entry + "\n");
+  } catch {
+    // Silently fail
+  }
+}
+
+/**
+ * Capture compaction event for evals (INLINED - do not import from opencode-swarm-plugin)
+ * 
+ * Writes COMPACTION events directly to session JSONL file.
+ * This is inlined to avoid import issues - plugin wrapper must be 100% self-contained.
+ * 
+ * Matches the structure of captureCompactionEvent from eval-capture.ts but writes
+ * ONLY to JSONL (not libSQL) to avoid swarm-mail dependency.
  * 
  * @param sessionID - Session ID
  * @param epicID - Epic ID (or "unknown" if not detected)
- * @param compactionType - Event type (detection_complete, prompt_generated, context_injected)
+ * @param compactionType - Event type (detection_complete, prompt_generated, context_injected, resumption_started, tool_call_tracked)
  * @param payload - Event-specific data (full prompts, detection results, etc.)
  */
 async function captureCompaction(
   sessionID: string,
   epicID: string,
-  compactionType: "detection_complete" | "prompt_generated" | "context_injected",
+  compactionType: "detection_complete" | "prompt_generated" | "context_injected" | "resumption_started" | "tool_call_tracked",
   payload: any,
 ): Promise<void> {
   try {
-    // Shell out to CLI - no imports needed, version always matches
-    const args = [
-      "capture",
-      "--session", sessionID,
-      "--epic", epicID,
-      "--type", compactionType,
-      "--payload", JSON.stringify(payload),
-    ];
+    // Build the CoordinatorEvent object matching eval-capture.ts schema
+    const event = {
+      session_id: sessionID,
+      epic_id: epicID,
+      timestamp: new Date().toISOString(),
+      event_type: "COMPACTION",
+      compaction_type: compactionType,
+      payload: payload,
+    };
+
+    // Session directory: ~/.config/swarm-tools/sessions/
+    const sessionDir = process.env.SWARM_SESSIONS_DIR || 
+      join(homedir(), ".config", "swarm-tools", "sessions");
     
-    const proc = spawn(SWARM_CLI, args, {
-      env: { ...process.env, SWARM_PROJECT_DIR: projectDirectory },
-      stdio: ["ignore", "ignore", "ignore"], // Fire and forget
+    // Ensure directory exists
+    if (!existsSync(sessionDir)) {
+      mkdirSync(sessionDir, { recursive: true });
+    }
+
+    // Write to JSONL (append mode)
+    const sessionPath = join(sessionDir, `${sessionID}.jsonl`);
+    const line = `${JSON.stringify(event)}\n`;
+    appendFileSync(sessionPath, line, "utf-8");
+
+    logCompaction("debug", "compaction_event_captured", {
+      session_id: sessionID,
+      epic_id: epicID,
+      compaction_type: compactionType,
+      session_path: sessionPath,
     });
-    
-    // Don't wait - capture is non-blocking
-    proc.unref();
   } catch (err) {
     // Non-fatal - capture failures shouldn't break compaction
     logCompaction("warn", "compaction_capture_failed", {
       session_id: sessionID,
+      epic_id: epicID,
       compaction_type: compactionType,
       error: err instanceof Error ? err.message : String(err),
     });
@@ -451,6 +601,14 @@ async function execTool(
         try {
           const result = JSON.parse(stdout);
           if (result.success && result.data !== undefined) {
+            // Log successful tool call
+            logTool(name, args, typeof result.data === "string" ? result.data : JSON.stringify(result.data));
+            
+            // Log Swarm Mail events separately
+            if (name.startsWith("swarmmail_")) {
+              logSwarmMail(`tool_${name}`, { args, result: result.data });
+            }
+            
             // Unwrap the data for cleaner tool output
             resolve(
               typeof result.data === "string"
@@ -463,17 +621,30 @@ async function execTool(
             const errorMsg = typeof result.error === "string" 
               ? result.error 
               : (result.error.message || "Tool execution failed");
+            
+            // Log failed tool call
+            logTool(name, args, undefined, errorMsg);
+            logError(`Tool ${name} failed`, { args, error: errorMsg });
+            
             reject(new Error(errorMsg));
           } else {
+            // Log successful (non-standard response)
+            logTool(name, args, stdout);
             resolve(stdout);
           }
         } catch {
+          // Log successful (unparseable response)
+          logTool(name, args, stdout);
           resolve(stdout);
         }
       } else if (code === 2) {
-        reject(new Error(`Unknown tool: ${name}`));
+        const errorMsg = `Unknown tool: ${name}`;
+        logError(errorMsg, { args });
+        reject(new Error(errorMsg));
       } else if (code === 3) {
-        reject(new Error(`Invalid JSON args: ${stderr}`));
+        const errorMsg = `Invalid JSON args: ${stderr}`;
+        logError(errorMsg, { tool: name, args });
+        reject(new Error(errorMsg));
       } else {
         // Tool returned error
         try {
@@ -483,15 +654,27 @@ async function execTool(
             const errorMsg = typeof result.error === "string"
               ? result.error
               : (result.error.message || `Tool failed with code ${code}`);
+            
+            logTool(name, args, undefined, errorMsg);
+            logError(`Tool ${name} failed with code ${code}`, { args, error: errorMsg });
+            
             reject(new Error(errorMsg));
           } else {
+            const errorMsg = stderr || stdout || `Tool failed with code ${code}`;
+            logTool(name, args, undefined, errorMsg);
+            logError(`Tool ${name} failed with code ${code}`, { args, stderr, stdout });
+            
             reject(
-              new Error(stderr || stdout || `Tool failed with code ${code}`),
+              new Error(errorMsg),
             );
           }
         } catch {
+          const errorMsg = stderr || stdout || `Tool failed with code ${code}`;
+          logTool(name, args, undefined, errorMsg);
+          logError(`Tool ${name} failed with code ${code}`, { args, stderr, stdout });
+          
           reject(
-            new Error(stderr || stdout || `Tool failed with code ${code}`),
+            new Error(errorMsg),
           );
         }
       }
@@ -669,6 +852,42 @@ const beads_link_thread = tool({
   execute: (args, ctx) => execTool("beads_link_thread", args, ctx),
 });
 
+// =============================================================================
+// Session Handoff Tools (Chainlink-inspired)
+// =============================================================================
+
+const hive_session_start = tool({
+  description: `Start a new work session with optional handoff notes from previous session.
+
+Chainlink-inspired session management for context preservation across sessions.
+Returns previous session's handoff notes if available.
+
+Credit: Chainlink session handoff pattern from https://github.com/dollspace-gay/chainlink`,
+  args: {
+    active_cell_id: tool.schema
+      .string()
+      .optional()
+      .describe("ID of cell being worked on"),
+  },
+  execute: (args, ctx) => execTool("hive_session_start", args, ctx),
+});
+
+const hive_session_end = tool({
+  description: `End current session with handoff notes for next session.
+
+Save context for the next agent/session to pick up where you left off.
+Include: what was done, what's next, any blockers or gotchas.
+
+Credit: Chainlink session handoff pattern from https://github.com/dollspace-gay/chainlink`,
+  args: {
+    handoff_notes: tool.schema
+      .string()
+      .optional()
+      .describe("Notes for next session (e.g., 'Completed X. Next: do Y. Watch out for Z.')"),
+  },
+  execute: (args, ctx) => execTool("hive_session_end", args, ctx),
+});
+
 // =============================================================================
 // Swarm Mail Tools (Embedded)
 // =============================================================================
@@ -1184,6 +1403,30 @@ const swarm_review_feedback = tool({
   execute: (args, ctx) => execTool("swarm_review_feedback", args, ctx),
 });
 
+// =============================================================================
+// Adversarial Review Tools (VDD/Chainlink-inspired)
+// =============================================================================
+
+const swarm_adversarial_review = tool({
+  description: `VDD-style adversarial code review using hostile, fresh-context agent.
+
+Spawns Sarcasmotron - a hyper-critical reviewer with zero tolerance for slop.
+Fresh context per review prevents "relationship drift" (becoming lenient over time).
+
+Returns structured critique with verdict:
+- APPROVED: Code is solid
+- NEEDS_CHANGES: Real issues found
+- HALLUCINATING: Adversary invented issues (code is excellent!)
+
+Credit: VDD methodology from https://github.com/Vomikron/VDD
+Credit: Chainlink patterns from https://github.com/dollspace-gay/chainlink`,
+  args: {
+    diff: tool.schema.string().describe("Git diff of changes to review"),
+    test_output: tool.schema.string().optional().describe("Test output (optional)"),
+  },
+  execute: (args, ctx) => execTool("swarm_adversarial_review", args, ctx),
+});
+
 // =============================================================================
 // Skills Tools
 // =============================================================================
@@ -2579,6 +2822,9 @@ const SwarmPlugin: Plugin = async (
       hive_cells,
       hive_sync,
       beads_link_thread,
+      // Session Handoff (Chainlink)
+      hive_session_start,
+      hive_session_end,
       // Swarm Mail (Embedded)
       swarmmail_init,
       swarmmail_send,
@@ -2617,6 +2863,8 @@ const SwarmPlugin: Plugin = async (
       // Structured Review
       swarm_review,
       swarm_review_feedback,
+      // Adversarial Review (VDD/Chainlink)
+      swarm_adversarial_review,
       // Skills
       skills_list,
       skills_read,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-swarm-plugin",
-  "version": "0.51.0",
+  "version": "0.53.0",
   "description": "Multi-agent swarm coordination for OpenCode with learning capabilities, beads integration, and Agent Mail",
   "type": "module",
   "main": "./dist/index.js",
@@ -64,7 +64,7 @@
     "minimatch": "^10.1.1",
     "pino": "^9.6.0",
     "pino-roll": "^1.3.0",
-    "swarm-mail": "1.8.0",
+    "swarm-mail": "1.9.0",
     "yaml": "^2.8.2",
     "zod": "4.1.8"
   },

package/dist/tools/ubs/index.d.ts

@@ -1,28 +0,0 @@
-/**
- * UBS (Ultimate Bug Scanner)
- *
- * Multi-language bug scanner for catching issues before they ship.
- * Inspired by Chainlink's post-edit-check.py stub detection.
- *
- * Credit: Chainlink project (https://github.com/dollspace-gay/chainlink)
- * for the stub pattern catalog.
- *
- * @example
- * ```typescript
- * import { scanFile, formatFindings } from "./tools/ubs";
- *
- * const code = `
- *   function example() {
- *     // TODO: implement this
- *     return null;
- *   }
- * `;
- *
- * const findings = scanFile(code, "example.ts");
- * console.log(formatFindings(findings));
- * ```
- */
-export type { Finding, ScanResult, Severity, Category } from "./types";
-export { scanFile, scanFiles, formatFindings, type ScanConfig, } from "./scanner";
-export { detectStubs, STUB_PATTERNS, type StubPattern } from "./patterns/stub-patterns";
-//# sourceMappingURL=index.d.ts.map

package/dist/tools/ubs/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/ubs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGvE,OAAO,EACL,QAAQ,EACR,SAAS,EACT,cAAc,EACd,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/tools/ubs/patterns/stub-patterns.d.ts

@@ -1,43 +0,0 @@
-/**
- * Stub Pattern Detection
- *
- * Detects incomplete/placeholder code patterns that AI (and humans) tend to leave behind.
- * Inspired by Chainlink's post-edit-check.py stub detection:
- * https://github.com/dollspace-gay/chainlink
- *
- * Credit: Chainlink project by @dollspace-gay for the stub pattern catalog
- *
- * These patterns catch "AI slop" - code that looks complete but isn't:
- * - TODO/FIXME/XXX/HACK comments
- * - Empty function bodies
- * - Placeholder returns (None, null with "stub" comment)
- * - Language-specific stub markers (pass, ..., unimplemented!(), todo!())
- */
-import type { Finding } from "../types";
-/**
- * Pattern definition for stub detection
- */
-export interface StubPattern {
-    /** Regex pattern to match */
-    pattern: RegExp;
-    /** Human-readable description */
-    description: string;
-    /** Optional suggestion for fix */
-    suggestion?: string;
-}
-/**
- * Stub detection patterns adapted from Chainlink
- *
- * These patterns are language-agnostic where possible, but include
- * language-specific markers for Python, Rust, JavaScript/TypeScript.
- */
-export declare const STUB_PATTERNS: StubPattern[];
-/**
- * Detect stub patterns in code
- *
- * @param code - Source code to scan
- * @param filePath - Path to file being scanned
- * @returns Array of findings
- */
-export declare function detectStubs(code: string, filePath: string): Finding[];
-//# sourceMappingURL=stub-patterns.d.ts.map

package/dist/tools/ubs/patterns/stub-patterns.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stub-patterns.d.ts","sourceRoot":"","sources":["../../../../src/tools/ubs/patterns/stub-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IAEpB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,EA4EtC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAyBrE"}

package/dist/tools/ubs/scanner.d.ts

@@ -1,49 +0,0 @@
-/**
- * UBS (Ultimate Bug Scanner) - Main Scanner Module
- *
- * Coordinates pattern detection across multiple categories.
- * Currently supports:
- * - Stub detection (incomplete/placeholder code)
- *
- * Future categories:
- * - Null safety
- * - Security (XSS, injection)
- * - Async/await issues
- * - Memory leaks
- * - Type coercion
- */
-import type { Finding, ScanResult } from "./types";
-/**
- * Scanner configuration
- */
-export interface ScanConfig {
-    /** Categories to scan (empty = all) */
-    categories?: Array<"stub" | "null-safety" | "security">;
-    /** Minimum severity to report */
-    minSeverity?: "low" | "medium" | "high" | "critical";
-}
-/**
- * Scan a single file for issues
- *
- * @param code - Source code to scan
- * @param filePath - Path to file being scanned
- * @param config - Scanner configuration
- * @returns Array of findings
- */
-export declare function scanFile(code: string, filePath: string, config?: ScanConfig): Finding[];
-/**
- * Scan multiple files
- *
- * @param files - Map of file path to file content
- * @param config - Scanner configuration
- * @returns Scan result with all findings
- */
-export declare function scanFiles(files: Map<string, string>, config?: ScanConfig): ScanResult;
-/**
- * Format findings for display
- *
- * @param findings - Findings to format
- * @returns Formatted string
- */
-export declare function formatFindings(findings: Finding[]): string;
-//# sourceMappingURL=scanner.d.ts.map

package/dist/tools/ubs/scanner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/tools/ubs/scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,aAAa,GAAG,UAAU,CAAC,CAAC;IAExD,iCAAiC;IACjC,WAAW,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;CACtD;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,UAAe,GACtB,OAAO,EAAE,CAwBX;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,MAAM,GAAE,UAAe,GACtB,UAAU,CAcZ;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAoB1D"}

package/dist/tools/ubs/types.d.ts

@@ -1,46 +0,0 @@
-/**
- * UBS (Ultimate Bug Scanner) Type Definitions
- *
- * Core types for bug detection and reporting.
- */
-/**
- * Severity levels for findings
- */
-export type Severity = "low" | "medium" | "high" | "critical";
-/**
- * Category of finding
- */
-export type Category = "null-safety" | "security" | "async-await" | "memory-leak" | "type-coercion" | "stub" | "other";
-/**
- * A detected issue in code
- */
-export interface Finding {
-    /** Category of the issue */
-    category: Category;
-    /** Human-readable description */
-    message: string;
-    /** File path where issue was found */
-    file: string;
-    /** Line number (1-based) */
-    line: number;
-    /** Column number (1-based), if available */
-    column?: number;
-    /** Severity of the issue */
-    severity: Severity;
-    /** Suggested fix, if available */
-    suggestion?: string;
-}
-/**
- * Result of a scan operation
- */
-export interface ScanResult {
-    /** All findings */
-    findings: Finding[];
-    /** Files scanned */
-    filesScanned: number;
-    /** Timestamp of scan */
-    timestamp: string;
-    /** Exit code (0 = no issues, 1 = issues found) */
-    exitCode: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/tools/ubs/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/ubs/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,aAAa,GACb,UAAU,GACV,aAAa,GACb,aAAa,GACb,eAAe,GACf,MAAM,GACN,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,4BAA4B;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IAEnB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAEhB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IAEb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IAEb,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,4BAA4B;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IAEnB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,mBAAmB;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IAEpB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IAErB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAElB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;CAClB"}