What's Changed

• feat: Enhanced step debugging with AI Dasein partnership approach by @koriym in #22
• feat: Add AI-optimized help documentation for all xdebug tools by @koriym in #23
• feat: Add branch coverage analysis with GraphViz visualization by @koriym in #24
• Support dynamic xdebug.trace_output_name patterns in trace file by @o0h in #25

New Contributors

• @o0h made their first contribution in #25

Full Changelog: v0.2.1...v0.3.1

🎯 Highlights

AI-Optimized Help Documentation

• Comprehensive --help output for all xdebug tools with AI-first design philosophy
• Clear value propositions and workflow integration for each tool
• Practical usage patterns comparing benefits vs traditional debugging methods

Branch Coverage Visualization

• GraphViz integration for visual branch coverage analysis
• Enhanced coverage insights beyond line coverage

Enhanced Debugging Experience

• Improved xdebug-coverage with automatic PHPUnit integration
• Default to php vendor/bin/phpunit --no-coverage when no arguments provided
• Non-invasive debugging with JSON output optimized for AI consumption

MCP Tool Improvements

• Fixed argument parsing for better Claude Code compatibility
• Improved shell escaping and validation
• All 4 slash commands (x-trace, x-debug, x-profile, x-coverage) work reliably

📚 Documentation

• Updated README with AI-first design philosophy
• Enhanced tool usage guidance
• Comprehensive help system across all tools

🔧 Installation

composer require koriym/xdebug-mcp:^0.3

Full Changelog: v0.2.1...v0.3.0

🔍 Enhanced Xdebug Detection & Vendor Filtering

This release focuses on improving Xdebug detection reliability and providing more granular control over vendor package filtering.

🎯 Key Features

🕵️ Intelligent Xdebug Detection System

• Automatic Discovery: Smart detection of Xdebug installations across multiple PHP versions
• Path Resolution: Comprehensive scanning of common installation locations
• Priority Ordering: Intelligent system path scanning with proper prioritization
• Better Diagnostics: Enhanced error reporting for Xdebug configuration issues

📦 Enhanced Vendor Filtering

• Advanced Control: Improved --include-vendor option with pattern matching
• Granular Filtering: Fine-grained control over vendor package inclusion/exclusion
• Wildcard Support: Pattern-based targeting (e.g., bear/*, symfony/console)
• Backward Compatible: Maintains existing filtering behavior

🛠️ Usage Examples

# Include specific vendor packages
./bin/xdebug-trace --include-vendor="bear/resource,psr/log" script.php

# Include entire vendor namespace
./bin/xdebug-trace --include-vendor="symfony/*" script.php

# Multiple patterns
./bin/xdebug-trace --include-vendor="bear/*,doctrine/orm" script.php

🚧 Experimental Infrastructure

This release also includes experimental infrastructure for future advanced debugging capabilities:

• Basic profiler directory structure
• Development planning and architectural documentation
• Foundation for upcoming AI debugging features

🔧 Improvements

• More reliable Xdebug detection across different environments
• Better vendor filtering performance and accuracy
• Enhanced CLI error messages and diagnostics
• Improved cross-platform compatibility

🔗 Full Changelog

See CHANGELOG.md for complete details.

Improved reliability and control for PHP debugging workflows.

Version 0.2.0 release

• Updated version to 0.2.0
• All tests passing (108 tests, 272 assertions)
• Comprehensive PHP Xdebug MCP Server functionality

🚀 First Stable Release

This is the first stable release of the Universal PHP Xdebug MCP Server, introducing revolutionary AI-powered debugging capabilities.

🎯 Key Innovation: Evidence-Based Debugging

Move from guesswork-driven to technology-driven debugging with actual runtime data analysis.

✨ Major Features

🤖 JSON Schema Support for AI Integration

• --json flag for structured AI-optimized output
• Complete JSON Schema (draft-07) with validation
• AI analysis guidelines for trace interpretation
• File size-based reading strategies for optimal AI processing

📊 AI-Optimized Debugging Workflow

• Evidence-based analysis using Xdebug trace data
• 30-second root cause identification vs hours of guesswork
• Non-invasive debugging - zero source code modification
• Comprehensive execution visibility with conditional breakpoints

📚 Complete Documentation & Integration

• GitHub Pages publication at https://koriym.github.io/xdebug-mcp/
• AI debugging principles for modern development workflows
• Practical examples showing dramatic efficiency improvements
• Professional package configuration with proper export handling

🛡️ Quality & Security

• Command argument escaping with escapeshellarg()
• URL validation workflow for documentation integrity
• Comprehensive error handling and input validation
• GitHub Actions CI for quality assurance

🛠️ Complete Xdebug Toolset

• xdebug-debug - Conditional breakpoint debugging (NEW: JSON support)
• xdebug-profile - Performance profiling
• xdebug-trace - Execution flow analysis
• xdebug-coverage - Code coverage reporting
• xdebug-phpunit - PHPUnit integration
• xdebug-mcp - MCP server for AI integration

📈 Real-World Impact

Before (Var_Dump Age 💃)

var_dump($cart);     // What's in cart?
var_dump($discount); // Check discount  
var_dump($total);    // Why is this negative?!
die("HERE");         // Getting desperate...
// 2 hours later: still guessing...

After (AI-Native Age 🤖)

./vendor/bin/xdebug-debug --break=checkout.php:89:$total<0 --json -- php app.php

# AI analyzes and reports in 30 seconds:
{"trace_file":"/tmp/trace.123.xt","lines":24,"size":1.2,"command":"php app.php"}

🚀 Installation

# Install stable release
composer require --dev koriym/xdebug-mcp

# Try AI-powered debugging
./vendor/bin/xdebug-debug --break='MyClass.php:42:$result==null' --json -- php app.php

# Enable MCP integration for Claude
claude mcp add xdebug php "$(pwd)/vendor/bin/xdebug-mcp"

📖 Documentation

• Main Documentation: https://koriym.github.io/xdebug-mcp/
• AI Debugging Guide: https://koriym.github.io/xdebug-mcp/ai-debugging-with-debugger.md
• JSON Schema: https://koriym.github.io/xdebug-mcp/schemas/xdebug-debug-v1.json

The revolution starts here. Welcome to the AI-Native Age of PHP debugging! 🤖✨