opencode-hive 1.3.5 → 1.4.3

package/templates/context/tools.md

@@ -0,0 +1,83 @@
+# Available Research Tools
+
+Reference for Forager and Scout Bees on available MCP tools.
+
+## Code Search
+
+| Tool | Purpose | When to Use |
+|------|---------|-------------|
+| `grep_app_searchGitHub` | GitHub code search | Find real-world examples, patterns in OSS |
+| `ast_grep_search` | AST pattern matching | Find code structures, refactoring targets |
+| `ast_grep_replace` | AST refactoring | Safe code transformations (use dryRun=true first) |
+
+### grep_app Examples
+```
+grep_app_searchGitHub({ query: "useEffect cleanup", language: ["TypeScript"] })
+grep_app_searchGitHub({ query: "(?s)try {.*await", useRegexp: true })
+```
+
+### ast_grep Examples
+```
+ast_grep_search({ pattern: "console.log($MSG)", lang: "typescript" })
+ast_grep_replace({ pattern: "console.log($MSG)", rewrite: "logger.info($MSG)", lang: "typescript", dryRun: true })
+```
+
+## Documentation
+
+| Tool | Purpose | When to Use |
+|------|---------|-------------|
+| `context7_resolve-library-id` | Find library ID | Before querying docs |
+| `context7_query-docs` | Query library docs | API usage, best practices |
+
+### context7 Flow
+1. `context7_resolve-library-id({ query: "how to use X", libraryName: "react" })`
+2. Get libraryId from result (e.g., `/facebook/react`)
+3. `context7_query-docs({ libraryId: "/facebook/react", query: "useEffect cleanup" })`
+
+## Web Search
+
+| Tool | Purpose | When to Use |
+|------|---------|-------------|
+| `websearch_web_search_exa` | Exa AI search | Current info, recent developments |
+
+### websearch Examples
+```
+websearch_web_search_exa({ query: "Next.js 15 new features 2026", numResults: 5 })
+```
+
+## Delegation
+
+| Tool | Purpose | When to Use |
+|------|---------|-------------|
+| `hive_background_task` | Spawn async subagent | Parallel exploration via Scout fan-out |
+
+### Parallel Exploration (Preferred)
+
+In task mode, use task() for research fan-out; in hive mode, use hive_background_task.
+
+For exploratory research, load `hive_skill("parallel-exploration")` for the full playbook.
+
+Quick pattern:
+```
+hive_background_task({ 
+  agent: "scout-researcher", 
+  prompt: "Find all API routes in src/ and summarize patterns",
+  description: "Explore API patterns",
+  sync: false
+})
+```
+
+Use `hive_background_output({ task_id })` to retrieve results when notified.
+
+---
+
+## Tool Selection Guide
+
+| Need | Best Tool |
+|------|-----------|
+| Find code in THIS repo | `grep`, `glob`, `ast_grep_search` |
+| Find code in OTHER repos | `grep_app_searchGitHub` |
+| Understand a library | `context7_query-docs` |
+| Current events/info | `websearch_web_search_exa` |
+| Structural refactoring | `ast_grep_replace` |
+| Multi-domain exploration | `hive_skill("parallel-exploration")` + `hive_background_task` |

package/templates/mcp-servers.json

@@ -0,0 +1,27 @@
+{
+  "mcpServers": {
+    "grep_app": {
+      "command": "npx",
+      "args": ["-y", "grep-mcp"],
+      "description": "GitHub code search via grep.app"
+    },
+    "ast_grep": {
+      "command": "npx",
+      "args": ["-y", "@notprolands/ast-grep-mcp"],
+      "description": "AST-aware code search and refactoring"
+    },
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"],
+      "description": "Library documentation lookup"
+    },
+    "websearch_exa": {
+      "command": "npx",
+      "args": ["-y", "exa-mcp-server"],
+      "env": {
+        "EXA_API_KEY": "${EXA_API_KEY}"
+      },
+      "description": "Exa AI web search (requires API key)"
+    }
+  }
+}