@hung319/opencode-hive 1.4.2 → 1.4.4

package/README.md

@@ -187,7 +187,21 @@ Hive uses a config file at `~/.config/opencode/agent_hive.json`. You can customi
 | `websearch` | Web search via [Exa AI](https://exa.ai). Real-time web searches and content scraping. | Set `EXA_API_KEY` env var |
 | `context7` | Library documentation lookup via [Context7](https://context7.com). Query up-to-date docs for any programming library. | None |
 | `grep_app` | GitHub code search via [grep.app](https://grep.app). Find real-world code examples from public repositories. | None |
-| `ast_grep` | AST-aware code search and replace via [ast-grep](https://ast-grep.github.io). Pattern matching across 25+ languages. | None (runs via npx) |
+| `ast_grep` | Native NAPI-powered AST analysis. Pattern matching across 25+ languages. | Built-in (no npx needed) |
+| `pare_search` | Structured ripgrep/fd search with 65-95% token reduction. | None (runs via npx) |
+
+#### Native ast-grep Tools
+
+Instead of MCP-based ast-grep, this plugin includes native tools using `@ast-grep/napi`:
+
+| Tool | Description |
+|------|-------------|
+| `ast_grep_dump_syntax_tree` | Dump code's syntax structure for debugging |
+| `ast_grep_test_match_code_rule` | Test code against YAML rules |
+| `ast_grep_find_code` | Find code matching patterns in project |
+| `ast_grep_scan_code` | Scan for TypeScript bugs and best practices |
+| `ast_grep_rewrite_code` | Transform/refactor code with AST patterns |
+| `ast_grep_analyze_imports` | Analyze import usage in codebase |
 
 ### Per-Agent Skills
 
@@ -374,6 +388,172 @@ Override models for specific agents:
 }
 ```
 
+## Agent Booster Tools
+
+Ultra-fast code editing powered by Rust+WASM. **52x faster than Morph LLM, FREE (no API key required).**
+
+### Tools
+
+| Tool | Description |
+|------|-------------|
+| `hive_code_edit` | Ultra-fast code editing with automatic fallback |
+| `hive_lazy_edit` | Edit with `// ... existing code ...` markers |
+| `hive_booster_status` | Check agent-booster availability |
+
+### Usage
+
+```typescript
+// Edit with old/new content
+hive_code_edit({
+  path: "src/index.ts",
+  oldContent: "const old = 'value';",
+  newContent: "const new = 'updated';"
+})
+```
+
+### Lazy Edit Example
+
+```typescript
+// Use markers for partial code
+hive_lazy_edit({
+  path: "src/component.tsx",
+  snippet: `// ... existing code ...
+export const newFeature = () => { ... };
+// ... existing code ...`
+})
+```
+
+### Configuration
+
+```json
+{
+  "agentBooster": {
+    "enabled": false,
+    "serverUrl": "http://localhost:3001",
+    "serverPort": 3001
+  }
+}
+```
+
+## Vector Memory Tools
+
+Semantic memory search powered by HNSW indexing. Find memories by meaning, not just keywords.
+
+### Tools
+
+| Tool | Description |
+|------|-------------|
+| `hive_vector_search` | Semantic search across memories |
+| `hive_vector_add` | Add memory with vector indexing |
+| `hive_vector_status` | Check vector memory status |
+
+### Memory Types
+
+- `decision`: Architectural decisions, design choices
+- `learning`: Insights, discoveries, patterns found
+- `preference`: User preferences, coding style
+- `blocker`: Known blockers, workarounds
+- `context`: Important context about the project
+- `pattern`: Code patterns, recurring solutions
+
+### Usage
+
+```typescript
+// Add a memory
+hive_vector_add({
+  content: "Use async/await instead of .then() chains",
+  type: "learning",
+  scope: "async-patterns",
+  tags: ["javascript", "best-practice"]
+})
+
+// Search memories
+hive_vector_search({
+  query: "async patterns JavaScript",
+  type: "learning",
+  limit: 10
+})
+```
+
+### Configuration
+
+```json
+{
+  "vectorMemory": {
+    "enabled": false,
+    "indexPath": "~/.config/opencode/hive/vector-index",
+    "dimensions": 384
+  }
+}
+```
+
+## Hive Doctor
+
+System health check and optimization advisor. Checks dependencies, features, and provides recommendations.
+
+### Tools
+
+| Tool | Description |
+|------|-------------|
+| `hive_doctor` | Full health check with recommendations |
+| `hive_doctor_quick` | Quick status summary |
+
+### Usage
+
+```typescript
+// Full health check
+hive_doctor()
+
+// Quick check
+hive_doctor_quick()
+```
+
+### What it checks
+
+1. **Dependencies** - Optional packages installed and working
+   - @sparkleideas/agent-booster
+   - @sparkleideas/memory
+   - @ast-grep/napi
+   - @paretools/search
+   - @upstash/context7-mcp
+   - exa-mcp-server
+
+2. **Optimizations** - Features enabled in config
+   - snip (60-90% token reduction)
+   - vector memory (semantic search)
+   - agent booster (fast code editing)
+   - Docker sandbox (isolated environments)
+   - native ast-grep (fast AST analysis)
+   - pare-search (structured search)
+
+3. **Recommendations** - Suggestions for improvements
+
+### Example Output
+
+```json
+{
+  "status": "warning",
+  "checks": {
+    "dependencies": {
+      "total": 6,
+      "installed": 4,
+      "packages": [...]
+    },
+    "optimizations": {
+      "total": 6,
+      "enabled": 3,
+      "features": [...]
+    }
+  },
+  "recommendations": [
+    "Enable vector memory for semantic search across memories"
+  ],
+  "quickFixes": [
+    { "command": "npm install @sparkleideas/memory", "description": "Install vector-memory" }
+  ]
+}
+```
+
 ## License
 
 MIT with Commons Clause — Free for personal and non-commercial use. See [LICENSE](../../LICENSE) for details.