fractalizer/ai-mess-detector

CLI tool for static analysis of PHP code - detects architectural mess and complexity issues

Maintainers

Package info

github.com/FractalizeR/php_ai_mess_detector

pkg:composer/fractalizer/ai-mess-detector

Statistics

Installs: 5

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v0.2.2 2026-03-05 20:07 UTC

Requires

Requires (Dev)

Suggests

  • ext-igbinary: For faster serialization in parallel processing
  • ext-parallel: For true parallel processing with threads (alternative to ext-pcntl)
  • ext-pcntl: Required for parallel processing on Unix (alternative to ext-parallel)

MIT 2e43048187172b7724f9e7a60b5ae4d12eb17e88

  • Fractalizer

phpcliMetricsarchitecturestatic-analysiscomplexitycode-qualitymess-detector

This package is auto-updated.

Last update: 2026-03-06 13:11:37 UTC

README

Static analysis tool for PHP code quality metrics.

Features

  • Complexity Metrics: Cyclomatic (CCN), Cognitive, NPATH
  • Maintainability: Halstead metrics, Maintainability Index
  • Coupling: RFC, Instability, Abstractness, Distance from Main Sequence
  • Cohesion: TCC/LCC, LCOM4, WMC
  • Size: LOC, Class/Method/Property Count
  • Structure: DIT, NOC
  • Architecture: Circular Dependency Detection

Quick Start

# Install
composer require --dev fractalizer/ai-mess-detector

# Analyze
bin/aimd analyze src/

# With specific format
bin/aimd analyze src/ --format=json

# Pre-commit hook
bin/aimd hook:install

Output Formats

Format Use Case
text CLI, human-readable
json CI/CD integration
checkstyle Jenkins, SonarQube
sarif GitHub Security, VS Code
gitlab GitLab Code Quality

Configuration

Create aimd.yaml:

rules:
  complexity:
    warning_threshold: 10
    error_threshold: 20

  cognitive:
    warning_threshold: 15
    error_threshold: 30

Or use CLI options:

bin/aimd analyze src/ --cc-warning=10 --cc-error=20

Git Integration

# Analyze staged files only
bin/aimd analyze src/ --staged

# Show violations in changed files
bin/aimd analyze src/ --diff=main

Baseline Support

# Generate baseline for existing violations
bin/aimd analyze src/ --generate-baseline=baseline.json

# Use baseline
bin/aimd analyze src/ --baseline=baseline.json

Documentation

Requirements

  • PHP 8.4+
  • Composer

Development

composer install
composer test      # Run tests
composer phpstan   # Static analysis
composer check     # Full validation

License

MIT