releases/RELEASE_v0.2.0.md

RELEASE V0.2.0

🚀 Agent Shaker v0.2.0 - MCP Integration

Release Date: January 22, 2026

Overview

Agent Shaker v0.2.0 is a major release focused on MCP (Model Context Protocol) integration and frontend architecture modernization. This release enables seamless integration with GitHub Copilot and other AI agents, providing context-aware task coordination and real-time documentation sharing.

🎯 Major Features

MCP Protocol Implementation 🔌

JSON-RPC 2.0 Handler

  • Standardized communication protocol for AI agents
  • Full compliance with Model Context Protocol specification
  • Robust error handling and validation
  • Support for multiple concurrent agent connections

Server-Sent Events (SSE)

  • Real-time update capability for agent clients
  • Stream-based communication for continuous updates
  • Efficient bandwidth usage for high-frequency events
  • Automatic reconnection handling

Context-Aware Endpoints

  • Automatic project_id and agent_id injection from connection URL
  • Simplified API calls for agents without repeating parameters
  • Intelligent fallback chains for missing context data
  • Support for URL query parameters in MCP connections

Enhanced APIs

  • create_task with intelligent defaults (auto-assigns to self)
  • add_context with automatic metadata injection
  • Improved task lifecycle management
  • Better error messages and validation

Frontend Architecture Overhaul 🏗️

6 Modular Components

  • AgentModal.vue - Agent creation and management
  • TaskModal.vue - Task creation and editing
  • ContextModal.vue - Context documentation creation
  • ContextViewer.vue - Rich markdown rendering
  • ConfirmModal.vue - Confirmation dialogs
  • McpSetupModal.vue - MCP configuration setup

Utility Modules

  • formatters.js - Date, status, priority formatting utilities
  • dataHelpers.js - Data transformation and helpers
  • Enhanced code reusability across components

Composables

  • useMcpSetup.js - Centralized MCP configuration management
  • Reactive state management for setup flows
  • Validation and file generation logic

Code Reduction & Improvements

  • 40% code reduction in ProjectDetail.vue through componentization
  • Cleaner separation of concerns
  • Improved maintainability and testability
  • Easier to add new features

Enhanced Features ✨

Dynamic Server Connection Management

  • Server URL modal for runtime configuration
  • Switch between development and production environments
  • Persistent storage of server configuration
  • Visual feedback for connection status

Real-time Connection Status

  • Live connection indicator in UI
  • Agent online/offline status tracking
  • WebSocket connection monitoring
  • Auto-reconnection with exponential backoff

AgentCard Component

  • Setup, edit, and delete capabilities
  • Status display with color coding
  • Role and team information display
  • Quick actions for agent management

TaskCard Component

  • Streamlined task display with status, priority, and assignee
  • Quick actions for task updates
  • Visual status indicators
  • Drag-and-drop ready interface

Dashboard Statistics

  • Project count and status overview
  • Agent activity metrics
  • Task completion rate tracking
  • Context documentation stats

Project Status Management

  • Update project information
  • Archive completed projects
  • Delete projects with confirmation
  • Status-based filtering and display

Developer Experience 🛠️

10 Agent Role Options

  • frontend - Frontend development
  • backend - Backend API development
  • devops - DevOps and infrastructure
  • testing - QA and testing
  • design - UI/UX design
  • fullstack - Full-stack development
  • data - Data engineering and analytics
  • security - Security and compliance
  • mobile - Mobile app development
  • cloud - Cloud architecture

MCP Setup File Generation

  • Automatic .vscode/mcp.json generation
  • One-click download functionality
  • Pre-filled with actual project and agent IDs
  • Copy-to-clipboard support for easy configuration

Improved Settings Store

  • Dynamic API base URL management
  • Pinia-based state management
  • Persistent settings across sessions
  • Type-safe configuration

Enhanced Error Handling

  • Retry logic for failed API calls
  • User-friendly error messages
  • Error recovery suggestions
  • Detailed console logging for debugging

Smooth Animations and Loading States

  • Fade and slide transitions
  • Loading spinners and skeleton screens
  • Success and error notifications
  • Improved user feedback

🔧 Technical Improvements

Backend Enhancements

Transaction-Based CRUD Operations

  • Database transaction support for data consistency
  • Atomic multi-step operations
  • Rollback on errors
  • Proper constraint handling

MCP Protocol Handler

  • JSON-RPC 2.0 compliant implementation
  • Request/response validation
  • Error serialization according to spec
  • Support for batch requests

Improved API Call Mechanisms

  • Proper error handling with context
  • Request logging for debugging
  • Response validation
  • Timeout configuration

Frontend Improvements

Better State Management

  • Pinia store integration
  • Reactive computed properties
  • Side effect management with proper cleanup
  • Clear data flow

Enhanced Component Modularity

  • Single Responsibility Principle (SRP)
  • Prop validation with PropTypes
  • Emitter-based communication
  • Composition API usage

Performance Optimizations

  • Component lazy loading
  • Computed property caching
  • Event listener cleanup
  • Memory leak prevention

📊 What Changed

New Files

  • internal/mcp/handler.go - MCP protocol handler
  • internal/mcp/types.go - MCP data types
  • web/src/components/AgentModal.vue - Agent management modal
  • web/src/components/TaskModal.vue - Task creation modal
  • web/src/components/ContextModal.vue - Context creation modal
  • web/src/components/ContextViewer.vue - Markdown renderer
  • web/src/components/ConfirmModal.vue - Confirmation dialog
  • web/src/components/McpSetupModal.vue - MCP setup generator
  • web/src/utils/formatters.js - Formatting utilities
  • web/src/utils/dataHelpers.js - Data transformation helpers
  • web/src/composables/useMcpSetup.js - MCP setup composition

Modified Files

  • cmd/server/main.go - MCP server route registration
  • web/src/views/ProjectDetail.vue - Refactored to use new components
  • web/src/stores/settings.ts - Enhanced with dynamic API base URL
  • README.md - Updated with MCP integration guide
  • docs/API.md - Added MCP protocol documentation

Removed/Deprecated

  • Inline modal code in ProjectDetail.vue (moved to components)
  • Hardcoded styling (moved to Tailwind classes)
  • Manual state management (moved to Pinia store)

🚀 Getting Started

Docker Compose (Recommended)

git clone https://github.com/techbuzzz/agent-shaker.git
cd agent-shaker
docker-compose up -d

# Verify installation
curl http://localhost:8080/health

The API will be available at:

Local Development

Prerequisites

  • Go 1.21+
  • PostgreSQL 15+
  • Node.js 18+
  • npm or yarn

Setup

# Backend
go mod download
cp .env.example .env
# Edit .env with your database credentials
go run cmd/server/main.go

# Frontend (in web/ directory)
npm install
npm run dev

🔗 MCP Integration Guide

Connect AI Agents with MCP

  1. Get your IDs from the Project Dashboard

    • project_id - Click "Project Settings"
    • agent_id - Register new agent, copy the ID

  2. Create MCP Configuration

    {
  "servers": {
    "agent-shaker": {
      "url": "http://localhost:8080?project_id=YOUR_PROJECT_ID&agent_id=YOUR_AGENT_ID",
      "type": "http"
    }
  }
}

  3. Use with GitHub Copilot

    @copilot Create a task for authentication API

MCP Tools Available

  • create_task - Create tasks (auto-assigns to self)
  • list_tasks - List all tasks in project
  • claim_task - Claim a task for yourself
  • complete_task - Mark task as done
  • add_context - Share markdown documentation
  • list_contexts - Read contexts from all agents
  • get_my_identity - Get your agent identity
  • get_my_project - Get project details
  • update_my_status - Update your status
  • get_dashboard - Get project statistics

📚 Documentation

✅ Testing

Run the test suite:

# Backend tests
go test ./...

# Frontend tests (in web/ directory)
npm run test

# Check coverage
go test -cover ./...
npm run test:coverage

🐛 Bug Fixes

  • Fixed task assignment tracking in create_task endpoint
  • Corrected CORS health endpoint configuration
  • Improved database constraint handling
  • Enhanced array field support for PostgreSQL
  • Fixed WebSocket connection handling
  • Improved error serialization in MCP responses

📈 Performance Improvements

  • 40% reduction in frontend code size through componentization
  • Optimized re-renders with computed properties
  • Efficient real-time updates with SSE
  • Better memory management in component lifecycle
  • Lazy loading of modal components

🔒 Security

  • Input validation on all MCP endpoints
  • CORS properly configured for MCP connections
  • SQL injection prevention with parameterized queries
  • Secure WebSocket connections (wss)
  • Agent authentication via URL parameters

💬 Breaking Changes

None in this release. v0.2.0 is fully backward compatible with v0.1.x.

🙏 Contributors

  • Core team development
  • Community feedback and testing
  • Documentation and guides

🔗 Resources

📝 License

MIT License - see LICENSE file for details

🚀 Next Steps

v0.3.0 Roadmap

  • Multi-language support
  • Advanced task filtering and search
  • Agent skill profiling
  • Performance metrics dashboard
  • Custom workflow definitions
  • Integration with popular CI/CD platforms

Community Contributions

We welcome contributions! See CONTRIBUTING.md for guidelines.

Happy coding! 🎉

For issues, questions, or feature requests, please open an issue on GitHub.

Back to all documentation