mulesoft-dev-scripts 1.0.0
Open-source scripts and tools to solve common MuleSoft development and operations problems
License: MIT
Requires Python: >=3.7
Keywords: mulesoft, mule, devops, automation, ci-cd, testing, security, configuration

# 🚀 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](./config-validator) ✅
**Status:** Production Ready  
**Problems solved:** Missing/invalid `mule-artifact.json`, property placeholder resolution, secure property decryption failures, config drift, duplicate properties

### ⚙️ [Runtime Diagnostics](./runtime-diagnostics) ✅
**Status:** Production Ready  
**Problems solved:** App not starting, memory/port issues, classloader problems, version mismatches, Java compatibility, slow startup diagnosis

### 📊 [Log Analyzer](./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](./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](./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](./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](./architecture-analyzer) 🚧
**Status:** Planned  
**Problems solved:** God-flows, missing global error handling, poor retry strategies, bad connector usage, blocking operations, threading issues

### ☁️ [CloudHub Readiness](./cloudhub-readiness) 🚧
**Status:** Planned  
**Problems solved:** Wrong worker sizing, CPU/memory overuse, log retention issues, restart loops, deployment rollback gaps, scaling misconfigurations

### 📈 [Project Health](./project-health) 🚧
**Status:** Planned  
**Problems solved:** Flow dependency visualization, Mule project health scoring, code quality metrics

---

## 🎯 Quick Start

### Installation

**Option 1: Clone Repository**
```bash
git clone https://github.com/upendra-manike/mulesoft-dev-scripts.git
cd mulesoft-dev-scripts
```

**Option 2: Install from PyPI** (Coming Soon)
```bash
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:**
```bash
# 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`](./.cursorrules) and [`.ai-agent-metadata.json`](./.ai-agent-metadata.json) for details.

## 📝 License

MIT License - See individual project folders for details.

## 🤝 Contributing

We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.

- 🐛 Found a bug? [Open an issue](https://github.com/yourusername/mulesoft-dev-scripts/issues/new?template=bug_report.md)
- 💡 Have an idea? [Request a feature](https://github.com/yourusername/mulesoft-dev-scripts/issues/new?template=feature_request.md)
- 🔧 Want to contribute code? [Open a pull request](https://github.com/yourusername/mulesoft-dev-scripts/compare)

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**