🎯 Research-Swarm v1.2.0 Release: GOALIE SDK Integration & Multi-Provider Web Search

🚀 Release Summary

Version: 1.2.0
Date: November 4, 2025
Type: Minor Release - New Features
Status: ✅ Production Ready
Backward Compatible: ✅ Yes

---

🎯 Major Features

1. GOALIE SDK Integration

Integrated GOALIE (Goal-Oriented Action Planning) as first-class SDK:

• ✅ Intelligent goal decomposition using GOAP algorithms
• ✅ Automatic sub-goal generation with complexity estimation
• ✅ Adaptive swarm sizing per sub-goal complexity
• ✅ Multi-provider support (Claude, Gemini, OpenRouter)
• ✅ Graceful fallback if GOALIE unavailable

2. Multi-Provider Web Search Support

Not limited to Perplexity! Now supports:

• ✅ Google Gemini with Grounding - Real-time Google Search integration
• ✅ Claude with Web Search MCP Tools - Brave Search API integration
• ✅ OpenRouter - 200+ models including Perplexity
• ✅ Custom MCP Servers - Build your own search integrations

---

📦 New CLI Commands

# Goal-based research with GOAP planning
research-swarm goal-research "<goal>" [options]

# Create GOAP plan (planning only)
research-swarm goal-plan "<goal>"

# Decompose goal using GOALIE
research-swarm goal-decompose "<goal>"

# Explain GOAP planning
research-swarm goal-explain "<goal>"

---

🚀 Quick Start Examples

Example 1: GOALIE Goal-Based Research

npx research-swarm goal-research \
  "Comprehensive analysis of blockchain scalability solutions" \
  --depth 6 \
  --time 120

Example 2: Web Search with Google Gemini

export GOOGLE_GEMINI_API_KEY="your-key"
npx research-swarm goal-research \
  "Latest AI developments 2024" \
  --provider gemini \
  --depth 5

Example 3: Claude with Brave Search

export ANTHROPIC_API_KEY="sk-ant-..."
export BRAVE_API_KEY="your-brave-key"
export MCP_CONFIG_PATH="./mcp-config.json"

npx research-swarm goal-research \
  "Cybersecurity threats 2024" \
  --depth 7

---

📊 What Changed

New Dependencies

• goalie@^1.3.1 - GOAP planning engine

New Modules

• /lib/goalie-integration.js (381 lines) - GOALIE SDK integration
• /docs/WEB_SEARCH_INTEGRATION.md - Web search guide
• /docs/V1.2.0_RELEASE_NOTES.md - Release notes

Updated Files

• /bin/cli.js - Added 4 GOALIE commands
• /lib/index.js - Exported GOALIE functions
• /package.json - Version 1.2.0, goalie dependency
• /README.md - v1.2.0 features
• /CHANGELOG.md - v1.2.0 entry

---

✅ Testing & Validation

Docker Tests (Passed ✅)

• ✅ Docker image builds successfully
• ✅ Dependencies install correctly
• ✅ GOALIE commands functional
• ✅ API keys work in Docker
• ✅ All 5 test scenarios passed

Compatibility Tests (Passed ✅)

• ✅ v1.0.1 single-agent mode works
• ✅ v1.1.0 swarm mode works
• ✅ All existing commands functional
• ✅ 100% backward compatible

---

📚 Documentation

Complete documentation available:

• examples/research-swarm/docs/V1.2.0_RELEASE_NOTES.md
• examples/research-swarm/docs/WEB_SEARCH_INTEGRATION.md
• examples/research-swarm/CHANGELOG.md
• examples/research-swarm/README.md

---

🔄 Migration Path

For existing users: Zero changes required!

# Update to v1.2.0
npm update research-swarm

# All existing commands still work
npx research-swarm research researcher "task"
npx research-swarm list

Optional enhancements:

• Configure web search provider (Gemini/Claude/OpenRouter)
• Try GOALIE: npx research-swarm goal-plan "test"

---

📈 Performance

• GOALIE overhead: +30-60 seconds planning (one-time per goal)
• Adaptive sizing: ~15-30% cost reduction
• Web search: Real-time information (not limited by training cutoff)

---

🎓 Key Benefits

1. Intelligent Planning: GOAP algorithms optimize research strategy
2. Web Search Freedom: Not locked into single provider
3. Cost Optimization: Complexity-based swarm sizing
4. Real-Time Data: Gemini grounding with Google Search
5. Flexibility: Mix providers (Gemini planning + Claude execution)

---

🚀 Ready to Publish

• Code complete
• Tests passing
• Documentation updated
• Docker validated
• CHANGELOG updated
• README updated
• Awaiting npm publish

---

📞 Links

• Package: https://www.npmjs.com/package/research-swarm
• Repository: https://github.com/ruvnet/agentic-flow/tree/main/examples/research-swarm
• Documentation: examples/research-swarm/docs/
• Issues: https://github.com/ruvnet/agentic-flow/issues

---

v1.2.0: GOALIE Integration + Multi-Provider Web Search 🎯🔬

Review package.json, bin/cli.js, lib/index.js, README.md, CHANGELOG.md, and the v1.2.0 documentation listed in the issue. Verify the release checklist and npm package state, with completion defined as v1.2.0 being published while the documented commands, tests, and compatibility claims remain valid.