universal-mcp-orchestration/knowledge-base/quick-reference/SYSTEM_COMMANDS.md

🏆 UNIVERSAL AI DEVELOPMENT SYSTEM: 100% OPTIMIZED! Complete plug-and-play MCP orchestration with 20/20 agents operational, 101MB optimization, zero-error operations, and enterprise-grade reliability. Works with ANY project type at ANY scale.

# 🚀 System Commands Quick Reference

## 🎯 **ESSENTIAL COMMANDS**

### System Health Checks
```bash
# Check all services
curl -s http://localhost:3001/health | jq    # Bridge server
curl -s http://localhost:3002               # UI application  
curl -s http://localhost:3001/agents | jq   # Available agents

# Check processes
ps aux | grep real_mcp_bridge               # Bridge server process
docker ps | grep mcp-ui-app                 # UI container
```

### Test Feature Implementation
```bash
# Test real implementation
curl -X POST http://localhost:3001/execute \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "developer-agent",
    "tool": "implement_feature",
    "params": {
      "feature_description": "create test component",
      "target_directory": "/mnt/c/users/ytr_o/Desktop/MCP/mcp-ui-app/src/renderer/src",
      "file_type": "typescript"
    }
  }'
```

## 🔧 **TROUBLESHOOTING COMMANDS**

### Bridge Server Issues
```bash
# Restart bridge server
pkill -f real_mcp_bridge
cd /mnt/c/users/ytr_o/Desktop/MCP
nohup python real_mcp_bridge.py > real_bridge.log 2>&1 &

# Check logs
tail -f real_bridge.log
```

### UI Deployment Issues  
```bash
# Manual build and deploy
cd /mnt/c/users/ytr_o/Desktop/MCP/mcp-ui-app
npm run build
docker cp dist/renderer/. mcp-ui-app:/usr/share/nginx/html/
docker exec mcp-ui-app nginx -s reload

# Verify deployment
curl -s http://localhost:3002 | grep "index-"  # Check bundle name
```

### File Creation Verification
```bash
# Check if files were created
ls -la mcp-ui-app/src/renderer/src/components/
ls -la mcp-ui-app/src/renderer/src/types/

# Test MCP file operations
python -c "
import sys; sys.path.append('agents')
import base_mcp_server
result = base_mcp_server.write_file.fn('test.txt', 'test content')
print('Result:', result)
"
```

### Docker Container Management
```bash
# Container operations
docker logs mcp-ui-app -f                   # View UI logs
docker exec mcp-ui-app ls -la /usr/share/nginx/html/  # Check files
docker restart mcp-ui-app                   # Restart if needed

# Container health
docker exec mcp-ui-app nginx -t             # Test nginx config
docker exec mcp-ui-app nginx -s reload      # Reload nginx
```

## 🎭 **AGENT INTERACTION**

### Orchestration Manager
```bash
curl -X POST http://localhost:3001/execute \
  -d '{"agent": "orchestration-manager", "tool": "analyze_feature_request", "params": {"request": "create user dashboard"}}'
```

### Architecture Agent
```bash
curl -X POST http://localhost:3001/execute \
  -d '{"agent": "architecture-agent", "tool": "analyze_system_impact", "params": {"feature_description": "add authentication"}}'
```

### Developer Agent
```bash
curl -X POST http://localhost:3001/execute \
  -d '{"agent": "developer-agent", "tool": "implement_feature", "params": {"feature_description": "create toggle button"}}'
```

### File Operations
```bash
curl -X POST http://localhost:3001/execute \
  -d '{"agent": "base-file-ops", "tool": "read_file", "params": {"file_path": "mcp-ui-app/package.json"}}'
```

## 🔍 **DEBUGGING COMMANDS**

### Network Diagnostics
```bash
# Check port availability
ss -tlnp | grep :3001                       # Bridge server port
ss -tlnp | grep :3002                       # UI port

# Test connectivity
telnet localhost 3001                       # Bridge server
telnet localhost 3002                       # UI server
```

### File System Checks
```bash
# Check project structure
find mcp-ui-app/src -name "*.tsx" | head -10
find mcp-ui-app/src -name "*.css" | head -10
find mcp-ui-app/src -name "*.ts" | head -10

# Check recent files
ls -lat mcp-ui-app/src/renderer/src/components/ | head -10
```

### Performance Monitoring
```bash
# Monitor bridge server activity
tail -f real_bridge.log | grep "Created:"   # File creation events
tail -f real_bridge.log | grep "ERROR"      # Error events

# Monitor Docker resource usage
docker stats mcp-ui-app --no-stream         # Container resources
```

## 🎯 **QUICK FIXES**

### "Activity Log shows Reconnecting..."
```bash
# Browser cache issue - force refresh
# Ctrl+F5 (Windows) or Cmd+Shift+R (Mac)
# Or try incognito mode
```

### "Files not being created"
```bash
# Check MCP security paths (use relative paths)
# Verify: ls -la mcp-ui-app/src/renderer/src/components/
# Fix: Use relative paths from PROJECT_ROOT
```

### "Old version deployed"
```bash
# Force fresh deployment
cd mcp-ui-app && npm run build
docker exec mcp-ui-app rm -rf /usr/share/nginx/html/*
docker cp dist/renderer/. mcp-ui-app:/usr/share/nginx/html/
docker exec mcp-ui-app nginx -s reload
```

### "Bridge server not responding"
```bash
# Check if running
ps aux | grep real_mcp_bridge

# Restart if needed
pkill -f real_mcp_bridge
nohup python real_mcp_bridge.py > real_bridge.log 2>&1 &
```

## 🚀 **MAINTENANCE ROUTINES**

### Daily Health Check
```bash
# Quick system verification
curl -s http://localhost:3001/health && echo "✅ Bridge OK" || echo "❌ Bridge Failed"
curl -s http://localhost:3002 > /dev/null && echo "✅ UI OK" || echo "❌ UI Failed"
curl -s http://localhost:3001/agents | jq -r 'length' | xargs -I {} echo "✅ {} agents available"
```

### Weekly Backup
```bash
# Backup critical files
tar -czf mcp_backup_$(date +%Y%m%d).tar.gz \
  real_mcp_bridge.py \
  mcp_claude_integration.py \
  mcp-ui-app/src/ \
  knowledge-base/
```

### Emergency Reset
```bash
# If everything breaks, restart from known good state
docker restart mcp-ui-app
pkill -f real_mcp_bridge
sleep 2
nohup python real_mcp_bridge.py > real_bridge.log 2>&1 &
sleep 3
curl -s http://localhost:3001/health && echo "System restored"
```

---

**💡 Remember: Always check the MCP_RECIPE_BIBLE.md for comprehensive troubleshooting and technical details!**