opencode-swarm-plugin 0.43.0 → 0.44.0

package/src/index.ts

@@ -50,6 +50,7 @@ import { memoryTools } from "./memory-tools";
 import { observabilityTools } from "./observability-tools";
 import { researchTools } from "./swarm-research";
 import { evalTools } from "./eval-runner";
+import { contributorTools } from "./contributor-tools";
 import {
   guardrailOutput,
   DEFAULT_GUARDRAIL_CONFIG,
@@ -80,6 +81,7 @@ import { createCompactionHook } from "./compaction-hook";
  * - skills:* - Agent skills discovery, activation, and execution
  * - mandate:* - Agent voting system for collaborative knowledge curation
  * - semantic-memory:* - Semantic memory with vector embeddings (Ollama + PGLite)
+ * - contributor_lookup - GitHub contributor profile lookup with changeset credit generation
  *
  * @param input - Plugin context from OpenCode
  * @returns Plugin hooks including tools, events, and tool execution hooks
@@ -159,9 +161,10 @@ const SwarmPlugin: Plugin = async (
      * - beads:* - Legacy aliases (deprecated, use hive:* instead)
      * - agent-mail:init, agent-mail:send, agent-mail:reserve, etc. (legacy MCP)
      * - swarm-mail:init, swarm-mail:send, swarm-mail:reserve, etc. (embedded)
- * - repo-crawl:readme, repo-crawl:structure, etc.
- * - mandate:file, mandate:vote, mandate:query, etc.
- * - semantic-memory:store, semantic-memory:find, semantic-memory:get, etc.
+  * - repo-crawl:readme, repo-crawl:structure, etc.
+  * - mandate:file, mandate:vote, mandate:query, etc.
+  * - semantic-memory:store, semantic-memory:find, semantic-memory:get, etc.
+  * - contributor_lookup - GitHub contributor profile lookup with changeset credits
  */
      tool: {
       ...hiveTools,
@@ -177,6 +180,7 @@ const SwarmPlugin: Plugin = async (
       ...observabilityTools,
       ...researchTools,
       ...evalTools,
+      ...contributorTools,
     },
 
     /**
@@ -516,6 +520,7 @@ export const allTools = {
   ...mandateTools,
   ...memoryTools,
   ...observabilityTools,
+  ...contributorTools,
 } as const;
 
 /**

package/src/sessions/agent-discovery.test.ts

@@ -0,0 +1,137 @@
+/**
+ * Agent Discovery Tests
+ * 
+ * Maps file paths to agent types using pattern matching.
+ * Follows TDD pattern from ADR-010 Section 4.5.
+ */
+
+import { describe, test, expect, afterEach } from "bun:test";
+import {
+  detectAgentType,
+  loadAgentPatterns,
+  resetAgentPatterns,
+} from "./agent-discovery";
+
+describe("detectAgentType", () => {
+  test("detects OpenCode Swarm sessions", () => {
+    expect(
+      detectAgentType(
+        "/home/user/.config/swarm-tools/sessions/ses_123.jsonl"
+      )
+    ).toBe("opencode-swarm");
+  });
+
+  test("detects Cursor sessions", () => {
+    expect(
+      detectAgentType(
+        "/Users/joel/Library/Application Support/Cursor/User/History/abc/9ScS.jsonl"
+      )
+    ).toBe("cursor");
+  });
+
+  test("detects OpenCode sessions", () => {
+    expect(detectAgentType("/Users/joel/.opencode/session.jsonl")).toBe(
+      "opencode"
+    );
+  });
+
+  test("detects Claude sessions", () => {
+    expect(
+      detectAgentType("/home/user/.local/share/Claude/ses_456.jsonl")
+    ).toBe("claude");
+  });
+
+  test("detects Aider sessions", () => {
+    expect(detectAgentType("/home/user/.aider/session.jsonl")).toBe("aider");
+  });
+
+  test("returns null for unknown paths", () => {
+    expect(detectAgentType("/tmp/random.jsonl")).toBeNull();
+  });
+
+  test("handles Windows-style paths", () => {
+    expect(
+      detectAgentType("C:\\Users\\joel\\.config\\swarm-tools\\sessions\\ses.jsonl")
+    ).toBe("opencode-swarm");
+  });
+
+  test("handles nested paths", () => {
+    expect(
+      detectAgentType(
+        "/Users/joel/.opencode/deeply/nested/folder/session.jsonl"
+      )
+    ).toBe("opencode");
+  });
+});
+
+describe("loadAgentPatterns", () => {
+  afterEach(() => {
+    // Reset to defaults after each test
+    resetAgentPatterns();
+  });
+
+  test("loads custom agent patterns", () => {
+    const count = loadAgentPatterns([
+      { pattern: "\\.codex[/\\\\]", agentType: "opencode-swarm" },
+    ]);
+
+    expect(count).toBe(1);
+    expect(detectAgentType("/home/user/.codex/session.jsonl")).toBe(
+      "opencode-swarm"
+    );
+  });
+
+  test("replaces default patterns with custom ones", () => {
+    loadAgentPatterns([
+      { pattern: "\\.custom[/\\\\]", agentType: "cursor" },
+    ]);
+
+    // Custom pattern works
+    expect(detectAgentType("/path/.custom/file.jsonl")).toBe("cursor");
+
+    // Default patterns no longer work
+    expect(
+      detectAgentType("/home/user/.config/swarm-tools/sessions/ses.jsonl")
+    ).toBeNull();
+  });
+
+  test("supports multiple custom patterns", () => {
+    loadAgentPatterns([
+      { pattern: "\\.agent1[/\\\\]", agentType: "opencode-swarm" },
+      { pattern: "\\.agent2[/\\\\]", agentType: "cursor" },
+      { pattern: "\\.agent3[/\\\\]", agentType: "claude" },
+    ]);
+
+    expect(detectAgentType("/path/.agent1/file.jsonl")).toBe(
+      "opencode-swarm"
+    );
+    expect(detectAgentType("/path/.agent2/file.jsonl")).toBe("cursor");
+    expect(detectAgentType("/path/.agent3/file.jsonl")).toBe("claude");
+  });
+});
+
+describe("resetAgentPatterns", () => {
+  test("restores default patterns after custom load", () => {
+    // Load custom patterns
+    loadAgentPatterns([
+      { pattern: "\\.custom[/\\\\]", agentType: "opencode-swarm" },
+    ]);
+
+    // Custom works, defaults don't
+    expect(detectAgentType("/path/.custom/file.jsonl")).toBe(
+      "opencode-swarm"
+    );
+    expect(
+      detectAgentType("/home/user/.config/swarm-tools/sessions/ses.jsonl")
+    ).toBeNull();
+
+    // Reset
+    resetAgentPatterns();
+
+    // Defaults work again
+    expect(
+      detectAgentType("/home/user/.config/swarm-tools/sessions/ses.jsonl")
+    ).toBe("opencode-swarm");
+    expect(detectAgentType("/path/.custom/file.jsonl")).toBeNull();
+  });
+});

package/src/sessions/agent-discovery.ts

@@ -0,0 +1,112 @@
+/**
+ * Agent Discovery Module
+ * 
+ * Maps file paths to agent types using pattern matching.
+ * Supports cross-platform paths (Unix and Windows).
+ * 
+ * @module sessions/agent-discovery
+ */
+
+/**
+ * Agent type identifier
+ */
+export type AgentType =
+  | "opencode-swarm"
+  | "cursor"
+  | "opencode"
+  | "claude"
+  | "aider";
+
+/**
+ * Path pattern configuration for agent type detection
+ */
+interface AgentPathPattern {
+  /** RegExp pattern to match against file path */
+  pattern: RegExp;
+  /** Agent type to return when pattern matches */
+  agentType: AgentType;
+}
+
+/**
+ * Default path patterns for agent type detection
+ * Order matters - first match wins
+ * 
+ * Can be overridden via loadAgentPatterns()
+ */
+let AGENT_PATH_PATTERNS: AgentPathPattern[] = [
+  { pattern: /\.config[\/\\]swarm-tools[\/\\]sessions[\/\\]/, agentType: "opencode-swarm" },
+  { pattern: /Cursor[\/\\]User[\/\\]History[\/\\]/, agentType: "cursor" },
+  { pattern: /\.opencode[\/\\]/, agentType: "opencode" },
+  { pattern: /\.local[\/\\]share[\/\\]Claude[\/\\]/, agentType: "claude" },
+  { pattern: /\.aider/, agentType: "aider" },
+];
+
+/**
+ * Configuration for custom agent patterns
+ */
+interface AgentPatternConfig {
+  /** Pattern string (will be converted to RegExp) */
+  pattern: string;
+  /** Agent type identifier */
+  agentType: AgentType;
+}
+
+/**
+ * Load custom agent patterns from config
+ * 
+ * @param patterns - Array of custom pattern configurations
+ * @returns Number of patterns loaded
+ * 
+ * @example
+ * ```typescript
+ * loadAgentPatterns([
+ *   { pattern: "\\.codex[/\\\\]", agentType: "codex" },
+ *   { pattern: "\\.gemini[/\\\\]", agentType: "gemini" }
+ * ]);
+ * ```
+ */
+export function loadAgentPatterns(patterns: AgentPatternConfig[]): number {
+  AGENT_PATH_PATTERNS = patterns.map(({ pattern, agentType }) => ({
+    pattern: new RegExp(pattern),
+    agentType,
+  }));
+  return AGENT_PATH_PATTERNS.length;
+}
+
+/**
+ * Reset agent patterns to defaults
+ * Useful for testing
+ */
+export function resetAgentPatterns(): void {
+  AGENT_PATH_PATTERNS = [
+    { pattern: /\.config[\/\\]swarm-tools[\/\\]sessions[\/\\]/, agentType: "opencode-swarm" },
+    { pattern: /Cursor[\/\\]User[\/\\]History[\/\\]/, agentType: "cursor" },
+    { pattern: /\.opencode[\/\\]/, agentType: "opencode" },
+    { pattern: /\.local[\/\\]share[\/\\]Claude[\/\\]/, agentType: "claude" },
+    { pattern: /\.aider/, agentType: "aider" },
+  ];
+}
+
+/**
+ * Detect agent type from file path
+ * 
+ * @param filePath - Absolute or relative file path (Unix or Windows)
+ * @returns Agent type identifier, or null if unknown
+ * 
+ * @example
+ * ```typescript
+ * detectAgentType("/home/user/.config/swarm-tools/sessions/ses_123.jsonl")
+ * // => "opencode-swarm"
+ * 
+ * detectAgentType("/tmp/random.jsonl")
+ * // => null
+ * ```
+ */
+export function detectAgentType(filePath: string): AgentType | null {
+  for (const { pattern, agentType } of AGENT_PATH_PATTERNS) {
+    if (pattern.test(filePath)) {
+      return agentType;
+    }
+  }
+  return null;
+}

package/src/sessions/index.ts

@@ -0,0 +1,15 @@
+/**
+ * Session Indexing Module
+ * 
+ * Provides agent session discovery and indexing capabilities.
+ * Part of the CASS Inhousing initiative (ADR-010).
+ * 
+ * @module sessions
+ */
+
+export {
+  detectAgentType,
+  loadAgentPatterns,
+  resetAgentPatterns,
+  type AgentType,
+} from "./agent-discovery";