---
name: ⚡ Performance Issue
about: Report performance problems, slowness, or optimization suggestions
title: "[PERFORMANCE] "
labels: "performance"
assignees: ""
---

## ⚡ Performance Issue Description

**What performance issue are you experiencing?**

- [ ] Slow response times
- [ ] High memory usage
- [ ] CPU usage spikes
- [ ] Cache inefficiency
- [ ] Network timeouts
- [ ] Large file handling issues

**Detailed description:** [Describe the specific performance problem you're encountering]

## 📊 Performance Metrics

**Current performance:**

- **Response time**: [e.g., 2-5 seconds average]
- **Memory usage**: [e.g., 500MB+ during operation]
- **CPU usage**: [e.g., 80%+ consistently]
- **Cache hit rate**: [e.g., 30% from cache stats]

**Expected performance:**

- **Target response time**: [e.g., <500ms]
- **Acceptable memory**: [e.g., <200MB]
- **Expected CPU**: [e.g., <50%]

**Performance test results:**

```bash
# Run performance tests and share results
npm run test:performance
npm run health
```

## 🌍 Environment Details

**System Configuration:**

- **OS**: [e.g., macOS 14.0, Ubuntu 22.04]
- **Hardware**: [CPU, RAM, disk type]
- **Node.js version**: [e.g., v20.10.0]
- **MCP WordPress version**: [e.g., v1.3.0]
- **Installation**: [NPM, Docker, source]

**WordPress Environment:**

- **WordPress version**: [e.g., 6.4.2]
- **Site size**: [posts, pages, media count]
- **Active plugins**: [especially cache/performance plugins]
- **Hosting environment**: [shared, VPS, dedicated, cloud]
- **Database size**: [approximate size if known]

**MCP Usage Pattern:**

- **Concurrent users/clients**: [number of simultaneous connections]
- **Request volume**: [requests per minute/hour]
- **Operation types**: [which tools are used most frequently]
- **Data volume**: [size of typical requests/responses]

## 🔄 Reproduction Steps

**To reproduce the performance issue:**

1. Configure MCP with [specific settings]
2. Execute [specific commands or operations]
3. Monitor [specific metrics]
4. Observe [performance degradation]

**Workload characteristics:**

- **Peak usage times**: [when does the issue occur]
- **Specific operations**: [which commands are slow]
- **Data patterns**: [large files, many posts, etc.]

## 📈 Monitoring Data

**Performance monitoring output:**

```bash
# Share output from performance monitoring
npm run test:performance
```

**Cache statistics:**

```bash
# Share cache efficiency data
wp_cache_stats --site=your-site
```

**System resource usage:**

```bash
# Monitor during issue occurrence
top -p $(pgrep node)
# Or on Windows: Task Manager screenshot
```

## 🔧 Optimization Attempts

**What have you tried?**

- [ ] Adjusted cache settings
- [ ] Modified rate limiting
- [ ] Changed authentication method
- [ ] Optimized WordPress configuration
- [ ] Updated system resources
- [ ] Disabled plugins

**Configuration changes tested:**

```json
{
  "caching": {
    "maxSize": "value tested",
    "defaultTTL": "value tested"
  }
}
```

**Results of optimization attempts:** [Describe what worked, what didn't, and measured improvements]

## 💡 Suggested Solutions

**Potential optimizations:**

- [ ] Cache configuration tuning
- [ ] Request batching/pagination
- [ ] Connection pooling
- [ ] Rate limiting adjustment
- [ ] Memory management improvements
- [ ] Database query optimization

**Specific suggestions:** [If you have ideas for performance improvements]

## 📊 Impact Assessment

**Business impact:**

- [ ] Blocks normal usage
- [ ] Significantly slows workflow
- [ ] Causes user frustration
- [ ] Increases infrastructure costs
- [ ] Minor inconvenience

**Affected operations:**

- [ ] All operations affected
- [ ] Specific tools: [list which ones]
- [ ] Only during peak usage
- [ ] Only with large datasets

## 🎯 Performance Goals

**Target metrics:**

- **Response time**: [specific goal, e.g., <500ms for 95% of requests]
- **Memory usage**: [target limit]
- **Throughput**: [requests per second goal]
- **Cache efficiency**: [target hit rate %]

**Acceptable degradation:** [What performance levels would be acceptable]

## 📝 Additional Context

**Performance comparisons:** [Compare with other tools, previous versions, or different environments]

**Logs and diagnostics:**

```text
[Share relevant performance logs, slow query logs, etc.]
```

**Profiling data:** [If you have profiling information, share it here]

---

**Checklist for submitters:**

- [ ] I've measured actual performance metrics
- [ ] I've tested with latest version
- [ ] I've tried basic optimization steps
- [ ] I've provided system specifications
- [ ] I've described the performance goal clearly
