eva-monorepo

EVA Ecosystem Monorepo

🎯 Overview

This monorepo consolidates all EVA ecosystem services into a unified codebase while maintaining zero-downtime migration from existing repositories. Each service can be developed and tested locally, then deployed to production independently.

🚀 Quick Start

Local Development

# Setup all services for local development
make setup-all

# Test all services
make test-all

# Work on individual services
cd services/eva-memory
make setup-eva-memory
make test-eva-memory
make run-eva-memory

Production Deployment

# Deploy all services to ~/Projects/services/
make deploy-all

# Deploy individual services
make deploy-eva-memory
make deploy-mcp-cloud-bridge

# Update Claude Desktop configuration
make configure-claude

📁 Repository Structure

eva-monorepo/
├── services/                     # Individual services
│   ├── eva-memory/               # Memory & Event Hub service
│   ├── mcp-desktop-gateway/      # Desktop MCP gateway
│   ├── mcp-bridge-service/       # Bridge service for integrations
│   └── eva-agent/                # Core EVA agent
├── packages/                     # Shared packages
│   ├── event-hub-client/         # Unified Event Hub client
│   ├── common-types/             # Shared TypeScript types
│   └── shared-utils/             # Common utilities
├── docker/                       # Docker configurations
├── scripts/                      # Monorepo management scripts
├── tools/                        # Build and development tools
└── docs/                         # Unified documentation

🚀 Quick Start

# Clone the monorepo
git clone https://github.com/[org]/eva-monorepo
cd eva-monorepo

# Install dependencies
npm install

# Run all services locally
npm run dev

# Run specific service
npm run dev:memory-service
npm run dev:desktop-gateway
npm run dev:bridge-service
npm run dev:eva-agent

📖 Documentation

• MIGRATION_GUIDE.md - Complete migration instructions
• ARCHITECTURE.md - Monorepo architecture
• DEVELOPMENT.md - Development workflow
• DEPLOYMENT.md - Production deployment guide

🛠️ Services

Memory Service (Event Hub)

• Source: https://github.com/[org]/eva-memory
• Purpose: Central memory management and event distribution
• Status: Production ready with Event Hub

Desktop Gateway

• Source: https://github.com/[org]/mcp-desktop-gateway
• Purpose: MCP protocol gateway for desktop applications
• Status: To be migrated

Bridge Service

• Source: https://github.com/[org]/mcp-bridge-service
• Purpose: Integration bridge for external services
• Status: To be migrated

EVA Agent

• Source: https://github.com/[org]/eva-agent
• Purpose: Core EVA assistant functionality
• Status: To be migrated

🔄 Migration Status

Service	Migration Status	Event Hub Integration	Production Ready
eva-memory	✅ Ready	✅ Native	✅ Yes
mcp-desktop-gateway	🔄 Planned	⏳ Pending	✅ Current
mcp-bridge-service	🔄 Planned	⏳ Pending	✅ Current
eva-agent	🔄 Planned	⏳ Pending	✅ Current

🏗️ Monorepo Tools

• Package Manager: npm workspaces / yarn workspaces
• Build System: Nx / Turborepo
• Version Management: Changesets
• CI/CD: GitHub Actions with path filtering
• Development: Docker Compose for local development

For detailed migration instructions, see docs/MIGRATION_GUIDE.md