🚀 MuleSoft Developer Scripts

A collection of open-source scripts and tools to solve common MuleSoft development and operations problems.

📋 Problem Categories

Each category is maintained as a separate project for easy maintenance and contribution.

✅ Ready to Use

🔧 Configuration Validator ✅

Status: Production Ready
Problems solved: Missing/invalid mule-artifact.json, property placeholder resolution, secure property decryption failures, config drift, duplicate properties

⚙️ Runtime Diagnostics ✅

Status: Production Ready
Problems solved: App not starting, memory/port issues, classloader problems, version mismatches, Java compatibility, slow startup diagnosis

📊 Log Analyzer ✅

Status: Production Ready
Problems solved: Log level misconfiguration, missing correlation IDs, log flooding, hard-to-read logs, tracing gaps, error handling issues

🔐 Security Scanner ✅

Status: Production Ready
Problems solved: Hardcoded secrets, weak TLS versions, missing API policies, insecure HTTP listeners, no rate limiting, token validation gaps

🔌 API Validator ✅

Status: Production Ready
Problems solved: API not reachable, listener issues, TLS/certificate problems, HTTP timeout misconfigurations, API Manager policy conflicts, CORS issues, RAML mismatches

🧪 MUnit Analyzer ✅

Status: Production Ready
Problems solved: MUnit coverage gaps, slow execution, test env mismatch, CI build failures, missing mocks, flaky tests

🚧 Coming Soon

🏗️ Architecture Analyzer 🚧

Status: Planned
Problems solved: God-flows, missing global error handling, poor retry strategies, bad connector usage, blocking operations, threading issues

☁️ CloudHub Readiness 🚧

Status: Planned
Problems solved: Wrong worker sizing, CPU/memory overuse, log retention issues, restart loops, deployment rollback gaps, scaling misconfigurations

📈 Project Health 🚧

Status: Planned
Problems solved: Flow dependency visualization, Mule project health scoring, code quality metrics

---

🎯 Quick Start

Installation

Option 1: Clone Repository

git clone https://github.com/upendra-manike/mulesoft-dev-scripts.git
cd mulesoft-dev-scripts

Option 2: Install from PyPI (Coming Soon)

pip install mulesoft-dev-scripts

Usage

Each project has its own README with installation and usage instructions. Navigate to the project folder and follow its specific setup.

Quick Example:

# Validate configuration
cd config-validator
python3 validate-properties.py --project-path /path/to/mule/project

# Or use example projects
python3 validate-properties.py --project-path ../examples/sample-mule-project

🤖 AI Agent Support

This repository is optimized for AI agents and includes:

• .cursorrules - Cursor AI agent rules for script discovery
• .ai-agent-metadata.json - Structured metadata for AI agent consumption
• Clear script descriptions - Each script has purpose, usage, and problem-solving documentation

AI agents can:

• Discover available scripts via metadata
• Understand when to use each script
• Generate appropriate commands
• Integrate scripts into workflows

See .cursorrules and .ai-agent-metadata.json for details.

📝 License

MIT License - See individual project folders for details.

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

• 🐛 Found a bug? Open an issue
• 💡 Have an idea? Request a feature
• 🔧 Want to contribute code? Open a pull request

Each project is maintained independently. See individual project READMEs for specific contribution guidelines.

⭐ Why This Exists

MuleSoft developers face the same problems repeatedly, but there's little high-quality open-source tooling available. These scripts solve real production pain points and help teams ship faster with fewer issues.

---

Created with ❤️ for the MuleSoft community