opencode-swarm-plugin 0.12.8 → 0.12.10

package/.beads/issues.jsonl

@@ -305,6 +305,7 @@
 {"id":"opencode-swarm-plugin-5ukv1","title":"Bead to start","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-10T09:06:07.140527-08:00","updated_at":"2025-12-10T09:06:10.259329-08:00","closed_at":"2025-12-10T09:06:10.259329-08:00"}
 {"id":"opencode-swarm-plugin-5uvt","title":"Limit test bead 3","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T07:46:49.108567-08:00","updated_at":"2025-12-08T07:46:51.736011-08:00","closed_at":"2025-12-08T07:46:51.736011-08:00"}
 {"id":"opencode-swarm-plugin-5x8v","title":"Bead to start","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T11:10:53.928154-08:00","updated_at":"2025-12-08T11:10:56.008815-08:00","closed_at":"2025-12-08T11:10:56.008815-08:00"}
+{"id":"opencode-swarm-plugin-5xy17","title":"Swarm should support research task decomposition with pdf-brain","description":"Currently swarm coordinator treats \"research\" tasks as single-agent work. Should decompose research into parallel agents that:\n\n1. Search different sources (pdf-brain, repo-crawl, cass, web)\n2. Focus on different aspects of the question\n3. Synthesize findings into coherent answer\n\nExample decomposition for \"debug levers for agent mail\":\n- Agent 1: Search pdf-brain for \"agent debugging\", \"MCP server configuration\"\n- Agent 2: Crawl the repo README, .env.example, config.py\n- Agent 3: Search cass for past sessions dealing with agent-mail errors\n- Agent 4: Synthesize findings from other agents\n\nStrategy selection should recognize research keywords:\n- research, investigate, explore, find, discover, understand, learn, analyze\n\nTool availability check:\n- If pdf-brain available, include PDF search subtask\n- If repo-crawl available, include repo exploration subtask\n- If cass available, include history search subtask\n\nFiles: src/swarm.ts (add research strategy), src/tool-availability.ts","status":"closed","priority":1,"issue_type":"feature","created_at":"2025-12-10T10:59:41.26917-08:00","updated_at":"2025-12-10T11:01:35.90704-08:00","closed_at":"2025-12-10T11:01:35.90704-08:00"}
 {"id":"opencode-swarm-plugin-5ztv","title":"New feature request","description":"","status":"closed","priority":1,"issue_type":"feature","created_at":"2025-12-08T11:12:40.764593-08:00","updated_at":"2025-12-08T11:12:43.52524-08:00","closed_at":"2025-12-08T11:12:43.52524-08:00"}
 {"id":"opencode-swarm-plugin-61t","title":"Single subtask epic","description":"","status":"closed","priority":1,"issue_type":"epic","created_at":"2025-12-07T19:36:07.443401-08:00","updated_at":"2025-12-07T19:36:09.031886-08:00","closed_at":"2025-12-07T19:36:09.031886-08:00"}
 {"id":"opencode-swarm-plugin-62da","title":"Update test bead","description":"Updated description","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T11:11:38.733772-08:00","updated_at":"2025-12-08T11:11:41.037318-08:00","closed_at":"2025-12-08T11:11:41.037318-08:00"}
@@ -947,6 +948,7 @@
 {"id":"opencode-swarm-plugin-jbdj","title":"Thread link test bead","description":"[thread:test-thread-456]","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T11:10:54.731569-08:00","updated_at":"2025-12-08T11:10:56.43993-08:00","closed_at":"2025-12-08T11:10:56.43993-08:00"}
 {"id":"opencode-swarm-plugin-jc9y","title":"Query test bead","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-07T19:39:29.328372-08:00","updated_at":"2025-12-07T19:39:31.358211-08:00","closed_at":"2025-12-07T19:39:31.358211-08:00"}
 {"id":"opencode-swarm-plugin-jdj","title":"Update test bead","description":"Updated description","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-07T19:39:10.007126-08:00","updated_at":"2025-12-07T19:39:11.999539-08:00","closed_at":"2025-12-07T19:39:11.999539-08:00"}
+{"id":"opencode-swarm-plugin-jf6gz","title":"Add repo-crawl tools to swarm plugin","description":"repo-crawl is essential for research tasks. Should be part of the plugin rather than a separate MCP server.\n\nTools to add:\n- repo_readme(repo) - Get README content\n- repo_structure(repo) - Get repo structure and tech stack\n- repo_tree(repo, path?) - Get directory tree\n- repo_file(repo, path) - Get file content\n- repo_search(repo, query) - Search code in repo\n\nImplementation:\n- Use GitHub API (unauthenticated for public repos, GITHUB_TOKEN for private)\n- Add to tool-availability.ts checks\n- Integrate with research-based strategy\n\nFiles: src/repo-crawl.ts (new), src/index.ts, src/tool-availability.ts","status":"open","priority":2,"issue_type":"feature","created_at":"2025-12-10T11:01:29.213791-08:00","updated_at":"2025-12-10T11:01:29.213791-08:00"}
 {"id":"opencode-swarm-plugin-jg4c","title":"Thread link test bead","description":"[thread:test-thread-123]","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:22:18.157665-08:00","updated_at":"2025-12-08T08:22:19.932643-08:00","closed_at":"2025-12-08T08:22:19.932643-08:00"}
 {"id":"opencode-swarm-plugin-jhk","title":"Limit test bead 2","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-07T19:39:18.330876-08:00","updated_at":"2025-12-07T19:39:20.45981-08:00","closed_at":"2025-12-07T19:39:20.45981-08:00"}
 {"id":"opencode-swarm-plugin-jiqn","title":"Single subtask epic","description":"","status":"closed","priority":1,"issue_type":"epic","created_at":"2025-12-07T19:57:07.022149-08:00","updated_at":"2025-12-07T19:57:08.738869-08:00","closed_at":"2025-12-07T19:57:08.738869-08:00"}

package/dist/index.js

@@ -23774,7 +23774,8 @@ var ErrorEntrySchema = exports_external.object({
 var DecompositionStrategySchema = exports_external.enum([
   "file-based",
   "feature-based",
-  "risk-based"
+  "risk-based",
+  "research-based"
 ]);
 var OutcomeSignalsSchema = exports_external.object({
   bead_id: exports_external.string(),
@@ -24138,8 +24139,7 @@ var STRATEGIES = {
       "hotfix",
       "patch",
       "audit",
-      "review",
-      "investigate"
+      "review"
     ],
     guidelines: [
       "Write tests FIRST to capture expected behavior",
@@ -24158,6 +24158,59 @@ var STRATEGIES = {
       "Fix race condition \u2192 [Add test reproducing issue, Implement fix, Add concurrency tests]",
       "Security audit \u2192 [Scan for vulnerabilities, Fix critical issues, Document remaining risks]"
     ]
+  },
+  "research-based": {
+    name: "research-based",
+    description: "Parallel search across multiple sources, then synthesize. Best for investigation, learning, and discovery tasks.",
+    keywords: [
+      "research",
+      "investigate",
+      "explore",
+      "find out",
+      "discover",
+      "understand",
+      "learn about",
+      "analyze",
+      "what is",
+      "what are",
+      "how does",
+      "how do",
+      "why does",
+      "why do",
+      "compare",
+      "evaluate",
+      "study",
+      "look up",
+      "look into",
+      "search for",
+      "dig into",
+      "figure out",
+      "debug options",
+      "debug levers",
+      "configuration options",
+      "environment variables",
+      "available options",
+      "documentation"
+    ],
+    guidelines: [
+      "Split by information source (PDFs, repos, history, web)",
+      "Each agent searches with different query angles",
+      "Include a synthesis subtask that depends on all search subtasks",
+      "Use pdf-brain for documentation/books if available",
+      "Use repo-crawl for GitHub repos if URL provided",
+      "Use cass for past agent session history",
+      "Assign NO files to research subtasks (read-only)"
+    ],
+    antiPatterns: [
+      "Don't have one agent search everything sequentially",
+      "Don't skip synthesis - raw search results need consolidation",
+      "Don't forget to check tool availability before assigning sources"
+    ],
+    examples: [
+      "Research auth patterns \u2192 [Search PDFs, Search repos, Search history, Synthesize]",
+      "Investigate error \u2192 [Search cass for similar errors, Search repo for error handling, Synthesize]",
+      "Learn about library \u2192 [Search docs, Search examples, Search issues, Synthesize findings]"
+    ]
   }
 };
 function selectStrategy(task) {
@@ -24165,13 +24218,21 @@ function selectStrategy(task) {
   const scores = {
     "file-based": 0,
     "feature-based": 0,
-    "risk-based": 0
+    "risk-based": 0,
+    "research-based": 0
   };
   for (const [strategyName, definition] of Object.entries(STRATEGIES)) {
     const name = strategyName;
     for (const keyword of definition.keywords) {
-      if (taskLower.includes(keyword)) {
-        scores[name] += 1;
+      if (keyword.includes(" ")) {
+        if (taskLower.includes(keyword)) {
+          scores[name] += 1;
+        }
+      } else {
+        const regex = new RegExp(`\\b${keyword}\\b`, "i");
+        if (regex.test(taskLower)) {
+          scores[name] += 1;
+        }
       }
     }
   }
@@ -25112,7 +25173,7 @@ var swarm_record_outcome = tool({
     success: tool.schema.boolean().describe("Whether the subtask succeeded"),
     files_touched: tool.schema.array(tool.schema.string()).optional().describe("Files that were modified"),
     criteria: tool.schema.array(tool.schema.string()).optional().describe("Criteria to generate feedback for (default: all default criteria)"),
-    strategy: tool.schema.enum(["file-based", "feature-based", "risk-based"]).optional().describe("Decomposition strategy used for this task")
+    strategy: tool.schema.enum(["file-based", "feature-based", "risk-based", "research-based"]).optional().describe("Decomposition strategy used for this task")
   },
   async execute(args) {
     const signals = {

package/dist/plugin.js

@@ -23748,7 +23748,8 @@ var ErrorEntrySchema = exports_external.object({
 var DecompositionStrategySchema = exports_external.enum([
   "file-based",
   "feature-based",
-  "risk-based"
+  "risk-based",
+  "research-based"
 ]);
 var OutcomeSignalsSchema = exports_external.object({
   bead_id: exports_external.string(),
@@ -24096,8 +24097,7 @@ var STRATEGIES = {
       "hotfix",
       "patch",
       "audit",
-      "review",
-      "investigate"
+      "review"
     ],
     guidelines: [
       "Write tests FIRST to capture expected behavior",
@@ -24116,6 +24116,59 @@ var STRATEGIES = {
       "Fix race condition \u2192 [Add test reproducing issue, Implement fix, Add concurrency tests]",
       "Security audit \u2192 [Scan for vulnerabilities, Fix critical issues, Document remaining risks]"
     ]
+  },
+  "research-based": {
+    name: "research-based",
+    description: "Parallel search across multiple sources, then synthesize. Best for investigation, learning, and discovery tasks.",
+    keywords: [
+      "research",
+      "investigate",
+      "explore",
+      "find out",
+      "discover",
+      "understand",
+      "learn about",
+      "analyze",
+      "what is",
+      "what are",
+      "how does",
+      "how do",
+      "why does",
+      "why do",
+      "compare",
+      "evaluate",
+      "study",
+      "look up",
+      "look into",
+      "search for",
+      "dig into",
+      "figure out",
+      "debug options",
+      "debug levers",
+      "configuration options",
+      "environment variables",
+      "available options",
+      "documentation"
+    ],
+    guidelines: [
+      "Split by information source (PDFs, repos, history, web)",
+      "Each agent searches with different query angles",
+      "Include a synthesis subtask that depends on all search subtasks",
+      "Use pdf-brain for documentation/books if available",
+      "Use repo-crawl for GitHub repos if URL provided",
+      "Use cass for past agent session history",
+      "Assign NO files to research subtasks (read-only)"
+    ],
+    antiPatterns: [
+      "Don't have one agent search everything sequentially",
+      "Don't skip synthesis - raw search results need consolidation",
+      "Don't forget to check tool availability before assigning sources"
+    ],
+    examples: [
+      "Research auth patterns \u2192 [Search PDFs, Search repos, Search history, Synthesize]",
+      "Investigate error \u2192 [Search cass for similar errors, Search repo for error handling, Synthesize]",
+      "Learn about library \u2192 [Search docs, Search examples, Search issues, Synthesize findings]"
+    ]
   }
 };
 function selectStrategy(task) {
@@ -24123,13 +24176,21 @@ function selectStrategy(task) {
   const scores = {
     "file-based": 0,
     "feature-based": 0,
-    "risk-based": 0
+    "risk-based": 0,
+    "research-based": 0
   };
   for (const [strategyName, definition] of Object.entries(STRATEGIES)) {
     const name = strategyName;
     for (const keyword of definition.keywords) {
-      if (taskLower.includes(keyword)) {
-        scores[name] += 1;
+      if (keyword.includes(" ")) {
+        if (taskLower.includes(keyword)) {
+          scores[name] += 1;
+        }
+      } else {
+        const regex = new RegExp(`\\b${keyword}\\b`, "i");
+        if (regex.test(taskLower)) {
+          scores[name] += 1;
+        }
       }
     }
   }
@@ -25062,7 +25123,7 @@ var swarm_record_outcome = tool({
     success: tool.schema.boolean().describe("Whether the subtask succeeded"),
     files_touched: tool.schema.array(tool.schema.string()).optional().describe("Files that were modified"),
     criteria: tool.schema.array(tool.schema.string()).optional().describe("Criteria to generate feedback for (default: all default criteria)"),
-    strategy: tool.schema.enum(["file-based", "feature-based", "risk-based"]).optional().describe("Decomposition strategy used for this task")
+    strategy: tool.schema.enum(["file-based", "feature-based", "risk-based", "research-based"]).optional().describe("Decomposition strategy used for this task")
   },
   async execute(args) {
     const signals = {

package/package.json

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

package/src/learning.ts

@@ -111,6 +111,7 @@ export const DecompositionStrategySchema = z.enum([
   "file-based",
   "feature-based",
   "risk-based",
+  "research-based",
 ]);
 export type DecompositionStrategy = z.infer<typeof DecompositionStrategySchema>;
 

package/src/swarm.ts

@@ -210,6 +210,7 @@ export type DecompositionStrategy =
   | "file-based"
   | "feature-based"
   | "risk-based"
+  | "research-based"
   | "auto";
 
 /**
@@ -316,7 +317,6 @@ export const STRATEGIES: Record<
       "patch",
       "audit",
       "review",
-      "investigate",
     ],
     guidelines: [
       "Write tests FIRST to capture expected behavior",
@@ -336,6 +336,60 @@ export const STRATEGIES: Record<
       "Security audit → [Scan for vulnerabilities, Fix critical issues, Document remaining risks]",
     ],
   },
+  "research-based": {
+    name: "research-based",
+    description:
+      "Parallel search across multiple sources, then synthesize. Best for investigation, learning, and discovery tasks.",
+    keywords: [
+      "research",
+      "investigate",
+      "explore",
+      "find out",
+      "discover",
+      "understand",
+      "learn about",
+      "analyze",
+      "what is",
+      "what are",
+      "how does",
+      "how do",
+      "why does",
+      "why do",
+      "compare",
+      "evaluate",
+      "study",
+      "look up",
+      "look into",
+      "search for",
+      "dig into",
+      "figure out",
+      "debug options",
+      "debug levers",
+      "configuration options",
+      "environment variables",
+      "available options",
+      "documentation",
+    ],
+    guidelines: [
+      "Split by information source (PDFs, repos, history, web)",
+      "Each agent searches with different query angles",
+      "Include a synthesis subtask that depends on all search subtasks",
+      "Use pdf-brain for documentation/books if available",
+      "Use repo-crawl for GitHub repos if URL provided",
+      "Use cass for past agent session history",
+      "Assign NO files to research subtasks (read-only)",
+    ],
+    antiPatterns: [
+      "Don't have one agent search everything sequentially",
+      "Don't skip synthesis - raw search results need consolidation",
+      "Don't forget to check tool availability before assigning sources",
+    ],
+    examples: [
+      "Research auth patterns → [Search PDFs, Search repos, Search history, Synthesize]",
+      "Investigate error → [Search cass for similar errors, Search repo for error handling, Synthesize]",
+      "Learn about library → [Search docs, Search examples, Search issues, Synthesize findings]",
+    ],
+  },
 };
 
 /**
@@ -360,13 +414,24 @@ export function selectStrategy(task: string): {
     "file-based": 0,
     "feature-based": 0,
     "risk-based": 0,
+    "research-based": 0,
   };
 
   for (const [strategyName, definition] of Object.entries(STRATEGIES)) {
     const name = strategyName as Exclude<DecompositionStrategy, "auto">;
     for (const keyword of definition.keywords) {
-      if (taskLower.includes(keyword)) {
-        scores[name] += 1;
+      // Use word boundary matching to avoid "debug" matching "bug"
+      // For multi-word keywords, just check includes (they're specific enough)
+      if (keyword.includes(" ")) {
+        if (taskLower.includes(keyword)) {
+          scores[name] += 1;
+        }
+      } else {
+        // Single word: use word boundary regex
+        const regex = new RegExp(`\\b${keyword}\\b`, "i");
+        if (regex.test(taskLower)) {
+          scores[name] += 1;
+        }
       }
     }
   }
@@ -1900,7 +1965,7 @@ export const swarm_record_outcome = tool({
         "Criteria to generate feedback for (default: all default criteria)",
       ),
     strategy: tool.schema
-      .enum(["file-based", "feature-based", "risk-based"])
+      .enum(["file-based", "feature-based", "risk-based", "research-based"])
       .optional()
       .describe("Decomposition strategy used for this task"),
   },