README

PHP Alert for Spaghetti Twisted Architecture

Order your code quality check - from Piccolo to Mamma Mia!

Detect spaghetti code using PHPMD metrics.

PASTA focuses on tangled, complex code - the kind that's hard to test, hard to change, and hard to understand. These issues aren't caught by type checkers like PHPStan or Psalm, yet they're often what kills project sustainability over time.

Unlike general code quality tools, it specifically targets metrics that indicate code entanglement: cyclomatic complexity, coupling, and structural bloat.

Requirements

• PHP 8.1+

Installation

As Claude Code Plugin

/plugin marketplace add koriym/pasta-lunch
/plugin install pasta-lunch@pasta-lunch

Via Composer

composer require --dev koriym/pasta-lunch

Usage

# Via composer script (default target: src)
composer pasta
composer pasta:html > report.html

# Direct execution
./vendor/bin/pasta
./vendor/bin/pasta --format=md > report.md
./vendor/bin/pasta --format=html > report.html

# Custom exclude patterns (default: *Module.php)
./vendor/bin/pasta src --exclude="*Module.php,*Test.php"

# No exclusions
./vendor/bin/pasta src --no-exclude

Composer Scripts

Add to your project's composer.json:

{
    "scripts": {
        "pasta": "bin/pasta src",
        "pasta:html": "bin/pasta src --format=html"
    }
}

Usage:

composer pasta
composer pasta:html > report.html

Spaghetti Levels

Demo

See Sample Report for an example HTML output.

Metrics

See Issue Types for detailed documentation.

Why these thresholds?

PASTA thresholds are designed around clean code ideals, not just "acceptable" levels. PHPMD defaults represent the point where "measures should be taken" - meaning code at those thresholds already needs attention.

• Piccolo = Clean, maintainable code
• Medio = Approaching PHPMD thresholds
• Grande = At or beyond PHPMD "action required" level
• Mamma Mia! = Critical, immediate refactoring needed

License

MIT