agentic-flow 1.9.0 → 1.9.2

package/docs/releases/archive/README.md

@@ -1,82 +0,0 @@
-# Version Releases Documentation
-
-This directory contains release notes, publication reports, and version-specific documentation for agentic-flow releases.
-
-## Release Reports
-
-### v1.5.11
-
-- **[PUBLICATION_REPORT_v1.5.11.md](./PUBLICATION_REPORT_v1.5.11.md)** - Publication report for version 1.5.11 with QUIC fixes and validation
-
-### v1.5.9
-
-- **[v1.5.9-RELEASE-SUMMARY.md](./v1.5.9-RELEASE-SUMMARY.md)** - Release summary and changelog
-- **[v1.5.9-DOCKER-VERIFICATION.md](./v1.5.9-DOCKER-VERIFICATION.md)** - Docker deployment verification for v1.5.9
-
-## Version History
-
-| Version | Release Date | Key Features | Status |
-|---------|--------------|--------------|--------|
-| 1.5.11 | 2024-10 | QUIC optimization, ReasoningBank WASM | ✅ Released |
-| 1.5.9 | 2024-10 | Docker improvements, bug fixes | ✅ Released |
-
-## Release Process
-
-Each release follows this standard process:
-
-1. **Development & Testing**
-   - Feature implementation
-   - Unit and integration testing
-   - Performance benchmarking
-
-2. **Validation**
-   - Regression testing
-   - Docker deployment verification
-   - Cross-platform compatibility checks
-
-3. **Documentation**
-   - Changelog generation
-   - Release notes
-   - Migration guides (if needed)
-
-4. **Publication**
-   - NPM package publication
-   - GitHub release creation
-   - Documentation updates
-
-## Release Documentation Standards
-
-All release documents include:
-- ✅ Version number and date
-- ✅ New features and enhancements
-- ✅ Bug fixes and patches
-- ✅ Breaking changes (if any)
-- ✅ Migration guide (if needed)
-- ✅ Known issues
-- ✅ Performance metrics
-- ✅ Validation results
-
-## Quick Links
-
-- [Main Changelog](../../CHANGELOG.md)
-- [Validation Reports](../validation-reports/)
-- [Integration Documentation](../integration-docs/)
-- [NPM Package](https://www.npmjs.com/package/agentic-flow)
-
-## Future Releases
-
-Upcoming versions are tracked in:
-- GitHub Issues
-- Project boards
-- [Plans directory](../plans/)
-
-## Versioning Scheme
-
-agentic-flow follows [Semantic Versioning](https://semver.org/):
-
-- **MAJOR.MINOR.PATCH** (e.g., 1.5.11)
-  - **MAJOR:** Breaking changes
-  - **MINOR:** New features (backward compatible)
-  - **PATCH:** Bug fixes (backward compatible)
-
-- **Alpha/Beta** releases use suffixes (e.g., 2.7.0-alpha.10)

package/docs/releases/archive/RELEASE-v1.2.0.md

@@ -1,339 +0,0 @@
-# Release Notes - agentic-flow v1.2.0
-
-**Release Date:** 2025-10-06
-**Version:** 1.2.0
-**Major Feature:** MCP CLI for User-Friendly Server Configuration
-
----
-
-## 🚀 What's New
-
-### MCP CLI Manager - Add Custom Servers Without Code Editing!
-
-**The Problem:** Previously, adding custom MCP servers required editing TypeScript code and rebuilding the project.
-
-**The Solution:** New CLI commands let end users add custom MCP servers without any code editing, similar to Claude Desktop's approach.
-
-### New Commands
-
-```bash
-# Add MCP server (Claude Desktop style JSON config)
-npx agentic-flow mcp add weather '{"command":"npx","args":["-y","weather-mcp"],"env":{"API_KEY":"xxx"}}'
-
-# Add MCP server (simple flag-based config)
-npx agentic-flow mcp add github --npm @modelcontextprotocol/server-github --env "GITHUB_TOKEN=ghp_xxx"
-
-# Add local MCP server
-npx agentic-flow mcp add my-tools --local /path/to/server.js
-
-# List configured servers
-npx agentic-flow mcp list
-
-# Enable/disable servers
-npx agentic-flow mcp enable weather
-npx agentic-flow mcp disable weather
-
-# Remove server
-npx agentic-flow mcp remove weather
-
-# Update configuration
-npx agentic-flow mcp update weather --env "API_KEY=new-key"
-```
-
-### Key Benefits
-
-- ✅ **No Code Editing** - Add servers via CLI commands
-- ✅ **No TypeScript Required** - Suitable for non-developers
-- ✅ **No Rebuilding** - Changes take effect immediately
-- ✅ **Claude Desktop Compatible** - Same JSON config format
-- ✅ **Automatic Loading** - Servers load automatically in all agents
-- ✅ **Persistent Storage** - Configuration stored in `~/.agentic-flow/mcp-config.json`
-- ✅ **100% Backward Compatible** - No breaking changes
-
----
-
-## 📚 Documentation
-
-### User Guides
-- **[ADDING-MCP-SERVERS-CLI.md](./guides/ADDING-MCP-SERVERS-CLI.md)** (516 lines)
-  - Complete end-user guide for CLI commands
-  - Step-by-step examples
-  - Popular MCP servers list
-  - Troubleshooting section
-
-- **[ADDING-MCP-SERVERS.md](./guides/ADDING-MCP-SERVERS.md)** (570 lines)
-  - Developer integration guide
-  - Code examples for in-SDK and external servers
-  - Best practices
-
-### Validation Reports
-- **[MCP-CLI-VALIDATION-REPORT.md](./mcp-validation/MCP-CLI-VALIDATION-REPORT.md)**
-  - Complete validation results
-  - Live agent test with strange-loops MCP
-  - 100% test pass rate (8/8 tests)
-
-- **[IMPLEMENTATION-SUMMARY.md](./mcp-validation/IMPLEMENTATION-SUMMARY.md)**
-  - Technical implementation details
-  - Before/after comparison
-  - Security considerations
-
-- **[strange-loops-test.md](./mcp-validation/strange-loops-test.md)**
-  - Live agent test output
-  - Proof of integration working
-
----
-
-## 🔧 Technical Details
-
-### New Files
-
-**Implementation:**
-- `src/cli/mcp-manager.ts` (617 lines)
-  - Complete CLI tool with 8 commands
-  - JSON and flag-based config support
-  - Configuration management
-
-**Documentation:**
-- `docs/guides/ADDING-MCP-SERVERS-CLI.md`
-- `docs/guides/ADDING-MCP-SERVERS.md`
-- `docs/mcp-validation/MCP-CLI-VALIDATION-REPORT.md`
-- `docs/mcp-validation/IMPLEMENTATION-SUMMARY.md`
-- `docs/mcp-validation/strange-loops-test.md`
-- `docs/NPM-PUBLISH-GUIDE-v1.2.0.md`
-
-### Modified Files
-
-**Agent Integration:**
-- `src/agents/claudeAgent.ts` (lines 171-203)
-  - Auto-load user-configured MCP servers
-  - Read from `~/.agentic-flow/mcp-config.json`
-  - Merge with built-in servers
-
-**Documentation:**
-- Root `README.md` - Added "Add Custom MCP Servers" section
-- NPM `README.md` - Added "Add Custom MCP Servers" section
-
-### Configuration Format
-
-```json
-{
-  "servers": {
-    "server-name": {
-      "enabled": true,
-      "type": "npm" | "local",
-      "package": "npm-package@version",
-      "command": "npx" | "node" | "python3" | "docker",
-      "args": ["arg1", "arg2"],
-      "env": {
-        "API_KEY": "value"
-      },
-      "description": "Server description"
-    }
-  }
-}
-```
-
----
-
-## ✅ Validation Results
-
-### Live Agent Test
-
-**Test:** Added strange-loops MCP server and ran agent
-
-**Command:**
-```bash
-npx agentic-flow mcp add strange-loops '{"command":"npx","args":["-y","strange-loops","mcp","start"]}'
-npx agentic-flow --agent researcher --task "List all MCP tools"
-```
-
-**Result:** ✅ SUCCESS
-- Agent loaded strange-loops MCP server
-- Detected all 9 tools from the server
-- Tools immediately available to agent
-
-**Console Output:**
-```
-[agentic-flow] Loaded MCP server: strange-loops
-```
-
-**Tools Detected:**
-1. `mcp__strange-loops__system_info`
-2. `mcp__strange-loops__benchmark_run`
-3. `mcp__strange-loops__nano_swarm_create`
-4. `mcp__strange-loops__nano_swarm_run`
-5. `mcp__strange-loops__quantum_container_create`
-6. `mcp__strange-loops__quantum_superposition`
-7. `mcp__strange-loops__quantum_measure`
-8. `mcp__strange-loops__temporal_predictor_create`
-9. `mcp__strange-loops__temporal_predict`
-
-### Test Results Summary
-
-| Test | Status | Evidence |
-|------|--------|----------|
-| TypeScript Build | ✅ PASS | Compilation successful |
-| CLI Commands | ✅ PASS | All commands working |
-| JSON Config | ✅ PASS | Claude Desktop format supported |
-| Flag Config | ✅ PASS | Flag-based format supported |
-| Config Persistence | ✅ PASS | Stored in ~/.agentic-flow/ |
-| Agent Integration | ✅ PASS | Auto-load working |
-| Tool Discovery | ✅ PASS | All tools detected |
-| Backward Compatibility | ✅ PASS | No breaking changes |
-
-**Overall:** ✅ **100% PASS RATE (8/8 tests)**
-
----
-
-## 🎯 Use Cases
-
-### Add GitHub MCP Server
-```bash
-# Add official GitHub MCP
-npx agentic-flow mcp add github \
-  --npm @modelcontextprotocol/server-github \
-  --env "GITHUB_TOKEN=ghp_your_token"
-
-# Use it with agent
-npx agentic-flow --agent coder --task "Create issue on repo owner/repo"
-```
-
-### Add Weather MCP Server
-```bash
-# Add weather MCP
-npx agentic-flow mcp add weather \
-  --npm weather-mcp \
-  --env "WEATHER_API_KEY=your_key"
-
-# Use it
-npx agentic-flow --agent researcher --task "Get weather forecast for San Francisco"
-```
-
-### Add Local Development Server
-```bash
-# Add local MCP server
-npx agentic-flow mcp add dev-tools \
-  --local /home/user/projects/my-mcp/server.js
-
-# Use it
-npx agentic-flow --agent coder --task "Use my custom tools"
-```
-
----
-
-## 🚫 Breaking Changes
-
-**None.** This is a purely additive feature.
-
-- Existing environment variable approach still works
-- Existing code-based MCP registration still works
-- User-configured servers load alongside built-in servers
-- No changes to existing APIs
-
----
-
-## 🔮 Future Enhancements (v1.2.1+)
-
-### Planned Commands (Not in v1.2.0)
-
-**1. Test Command**
-```bash
-npx agentic-flow mcp test weather
-# Will test if server starts and responds correctly
-```
-
-**2. Info Command**
-```bash
-npx agentic-flow mcp info weather
-# Will show detailed server information
-```
-
-**3. Tools Command**
-```bash
-npx agentic-flow mcp tools weather
-# Will list all tools from specific server
-```
-
-**4. Export/Import**
-```bash
-npx agentic-flow mcp export > config.json
-npx agentic-flow mcp import < config.json
-# Share configurations with team
-```
-
-### Other Future Features
-- Shell completion (bash/zsh)
-- API key encryption in config
-- Server signature verification
-- Automatic server updates
-- Usage statistics
-
----
-
-## 📦 Installation
-
-### Global Install
-```bash
-npm install -g agentic-flow@1.2.0
-```
-
-### Use with npx (No Install)
-```bash
-npx agentic-flow@1.2.0 mcp add my-server --npm my-mcp-package
-```
-
-### Upgrade from Previous Version
-```bash
-npm update -g agentic-flow
-```
-
----
-
-## 🔗 Links
-
-**GitHub:**
-- Pull Request: https://github.com/ruvnet/agentic-flow/pull/4
-- Repository: https://github.com/ruvnet/agentic-flow
-- Issues: https://github.com/ruvnet/agentic-flow/issues
-
-**NPM:**
-- Package: https://www.npmjs.com/package/agentic-flow
-- Version: https://www.npmjs.com/package/agentic-flow/v/1.2.0
-
-**Documentation:**
-- User Guide: https://github.com/ruvnet/agentic-flow/blob/main/agentic-flow/docs/guides/ADDING-MCP-SERVERS-CLI.md
-- Developer Guide: https://github.com/ruvnet/agentic-flow/blob/main/agentic-flow/docs/guides/ADDING-MCP-SERVERS.md
-
----
-
-## 👏 Credits
-
-**Built by:** [@ruvnet](https://github.com/ruvnet)
-**Implemented with:** [Claude Code](https://claude.com/claude-code)
-**Based on:** [Claude Agent SDK](https://docs.claude.com/en/api/agent-sdk) by Anthropic
-
----
-
-## 📋 Quick Reference
-
-| Task | Command |
-|------|---------|
-| Add NPM server | `npx agentic-flow mcp add NAME --npm PACKAGE` |
-| Add local server | `npx agentic-flow mcp add NAME --local PATH` |
-| Add with JSON | `npx agentic-flow mcp add NAME '{"command":...}'` |
-| List servers | `npx agentic-flow mcp list` |
-| Enable server | `npx agentic-flow mcp enable NAME` |
-| Disable server | `npx agentic-flow mcp disable NAME` |
-| Remove server | `npx agentic-flow mcp remove NAME` |
-
-**Config File:** `~/.agentic-flow/mcp-config.json`
-
----
-
-**Release Status:** ✅ READY FOR PRODUCTION
-
-**Validation:** ✅ 100% TEST PASS RATE
-
-**Documentation:** ✅ COMPLETE
-
-**Ready to Publish:** ✅ YES