ContextQMD
Back to Ruflo

v2.7.28 Release Notes - Remove agentic-payments Auto-Install

v2/docs/V2.7.28_RELEASE_NOTES.md

3.6.305.6 KB
Original Source

v2.7.28 Release Notes - Remove agentic-payments Auto-Install

Release Date: 2025-11-06 Type: Enhancement Release Priority: Medium Related Issue: #857

🎯 Summary

Removed automatic installation of agentic-payments MCP server from the init process. Payment integrations are now opt-in, giving users more control over which tools are installed.

🔧 Changes Made

1. Removed from setupMcpServers Function (src/cli/simple-commands/init/index.js:104-120)

  • Removed agentic-payments server configuration
  • Reduced automatic MCP servers from 4 to 3:
    • ✅ claude-flow (core)
    • ✅ ruv-swarm (coordination)
    • ✅ flow-nexus (advanced features)
    • ❌ agentic-payments (removed)

2. Updated .mcp.json Configuration (src/cli/simple-commands/init/index.js:1440-1459)

  • Removed agentic-payments entry from MCP server config
  • Clean configuration with only essential servers

3. Cleaned Up Console Messages (src/cli/simple-commands/init/index.js)

  • Removed all references to agentic-payments in help text
  • Updated manual installation instructions
  • Maintained clarity in MCP setup guidance

4. Updated MCPIntegrator (src/core/MCPIntegrator.ts:153-202)

  • Removed agentic-payments tool registration
  • Removed payment-related function definitions:
    • create_active_mandate
    • sign_mandate
    • verify_mandate
    • revoke_mandate
    • generate_agent_identity
    • create_intent_mandate
    • create_cart_mandate

✅ Benefits

User Choice

  • Opt-In Installation: Users explicitly choose payment integrations
  • Cleaner Defaults: Only essential tools auto-installed
  • Better UX: No unexpected packages

Security

  • Reduced Attack Surface: Fewer automatic dependencies
  • Better Control: Users verify tools before installation
  • Explicit Trust: Payment tools require conscious decision

Performance

  • Faster Init: Fewer packages to install
  • Lighter Footprint: Reduced dependency chain
  • Quicker Setup: Streamlined initialization

📋 Testing

Docker Test Suite Created

File: tests/docker/Dockerfile.init-test

Test Scenarios:

  1. ✅ Dry-run init verification
  2. ✅ No agentic-payments in output
  3. ✅ Correct MCP server count (3)
  4. ✅ Actual init execution
  5. ✅ .mcp.json validation
  6. ✅ CLAUDE.md verification

Run Tests:

bash
# Build test image
docker build -f tests/docker/Dockerfile.init-test -t claude-flow-init-test:v2.7.28 .

# Run tests
docker run --rm claude-flow-init-test:v2.7.28

🔄 Migration Guide

For Users Who Need Agentic-Payments

Manual Installation:

bash
# After running init, add agentic-payments manually
claude mcp add agentic-payments npx agentic-payments@latest mcp

Or Add to .mcp.json:

json
{
  "mcpServers": {
    "claude-flow@alpha": { ... },
    "ruv-swarm": { ... },
    "flow-nexus": { ... },
    "agentic-payments": {
      "command": "npx",
      "args": ["agentic-payments@latest", "mcp"],
      "type": "stdio"
    }
  }
}

For Existing Users

No Action Required if you don't use agentic-payments.

If You Use Agentic-Payments:

  1. Existing installations are unaffected
  2. New projects require manual installation
  3. Add to .mcp.json if needed

📊 Impact Analysis

Before v2.7.28

  • Auto-installed: 4 MCP servers
  • Init time: ~15-20 seconds
  • Dependencies: Includes payment tools by default

After v2.7.28

  • Auto-installed: 3 MCP servers
  • Init time: ~12-15 seconds (20% faster)
  • Dependencies: Only core tools

🔍 Files Modified

Modified:
  • src/cli/simple-commands/init/index.js
  • src/core/MCPIntegrator.ts
  • bin/claude-flow (version bump)
  • package.json (version bump)

Created:
  • tests/docker/Dockerfile.init-test
  • docs/V2.7.28_RELEASE_NOTES.md

💡 Rationale

Why Remove Auto-Install?

  1. Security First: Payment tools should be explicitly chosen
  2. User Agency: Let users decide what to install
  3. Cleaner Defaults: Focus on core orchestration features
  4. Performance: Faster init for most users
  5. Clarity: Explicit is better than implicit

Why Not Make All Optional?

  • claude-flow: Core orchestration - always needed
  • ruv-swarm: Enhanced coordination - core feature
  • flow-nexus: Advanced features - commonly used
  • agentic-payments: Specialized use case - opt-in

🚀 Upgrade Path

NPX Users (Automatic)

bash
# Next run uses v2.7.28
npx claude-flow@latest init

Global Install Users

bash
npm update -g claude-flow

# Verify version
claude-flow --version  # Should show v2.7.28

🔗 Related Documentation

🎯 Future Enhancements

Potential improvements for future versions:

  1. Interactive Init: Prompt for optional tools
  2. Init Profiles: Pre-configured sets (minimal, full, custom)
  3. Tool Discovery: Auto-detect available MCP servers
  4. Config Templates: Common configurations for different use cases

📞 Support

If you have questions about this change:

  1. Check issue #857 for discussion
  2. Review migration guide above
  3. Report issues on GitHub

Feedback Welcome

We'd love to hear:

  • Does this improve your experience?
  • Should other tools be opt-in?
  • What init features would you like?

Full Changelog: v2.7.27...v2.7.28